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structure and use of the SPM-11M software supported by DIGITAL 
on RSX-11M operating systems. 
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This manual 


is for all users of SPM-11M. 


STRUCTURE OF THIS DOCUMENT 


Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Chapter 
Appendix 
Appendix 


Appendix 
Appendix 
Appendix 
Appendix 


Appendix 


7/81 


1 
2 


> 


is an overview of the architecture of SPM-11M. 


describes the components of SPM-11M. 


describes how to use SPM-11M. 


describes data collection and reduction procedures. 


describes how to read the performance report. 


delineates the resources used by SPM-11M. 


is the usage notes 


is a specification 


isa 
(MPB) 


specification 


is a specification 


is 
is 
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specification 


specification 


for SPM-11M. 
of the Hook Records. 


of the Monitor Parameter Block 


of the Information Records. 
of the System Metrics Record. 


of the logfile format. 


sample performance report. 


sample SMPGEN. 


CMD procedure. 


Chapter 1 
OVERVIEW OF SPM-11M 


The Software Performance Monitor (SPM-11M) is a software 
instrument used to measure the performance of a computer system 
running the RSX-11M operating system. 


SPM-11M is a natural counterpart to RSX-11M: while RSX-11M 
manages the resources of the computer system, SPM-11M remembers 
how the resources were used over a period of time, similar to 
the way a tape recorder remembers a set of sound patterns. 
Moreover, SPM-11M has the capability of "playing back" these 
recordings of resource usage, so an analyst can study how and 
when the resources were used. 
SPM-11M is an event driven performance monitor. As each event 
of interest occurs, the performance monitor is called. 
Ist RESOURCES 
The key resources of interest are: 

C) CPU 

e Main memory 

® 1/0 devices 

@ File system 

® Task loader 
Note that a resource can be a hardware resource -- such as the 


CPU, main memory or an I/0 device; or a software resource -- 
such as the file system or the task loader. 
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Is, USERS 


A user is the entity which uses the resources managed by the 
operating system. We define a user to be an RSX-11M task. Of 
primary concern is the workload the task places on the system, 
that is, how much and for how long the resources are used. To 
describe a task's workload we will define a set of metrics for 
resource usage. 


1.3 RESOURCE MODEL 


Because a number of tasks may concurrently request the use of a 
resource, and only one task may use the resource at a time, a 
queue will form for the resource. A simple queued resource is 
depicted as follows: 


The vertical bars represent the queued resource requests and 
the square represents the resource. Three intervals are shown 


on the diagram. "W" denotes the interval during which a task 
is waiting for the resource. "U" denotes an interval when a 
task is using the resource. "S* 18 the sum ot “W" cand: “Ue, 


called the service time. 


1.4 EVENTS 
The activity of the RSX-11M operating system can be traced by 
defining a set of key events and recording a set of raw infor- 
mation associated with each event. The events of interest are 
those which capture the metrics of resource usage. 
For example, we may want to know how long a task waits for the 
disk, how many times it uses the disk and how long it uses the 
disk. The following events are defined to capture the I/0 
activity: 

1. Queue I/0 packet to driver 

2. Driver gets I/0 packet 


3. Driver posts I/0 completion 
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Applied to the queued resource model for the disk, these I/0 
events appear as follows: 


ill=-LI 


1 2 3 


The complete set of events defined for RSX-11M is specified in 
Appendix A. 


leS TASK METRICS 


The task metrics quantify the workload that individual tasks 
place on the system. 


The task metrics are computed for all three types of intervals: 
U, Wand S. The performance report will contain a line of task 
metrics for each resource used by the task. The task metrics 
are: 


e Count 


A simple metric for resource usage is a count of the 
number of times the resource was used during the life 
of a task. For example, if a task does four QIOs to a 
disk, the I/0 request count is four. 


) Total Time 


Another simple metric is how long the task uses a 
resource. For example, if a task did four QIOs and 
the I/0 requests took 20ms, 60ms, 10ms and 50ms to 
complete, the total usage time would be 140ms. 


® % Resident Time 


Also of importance is what percentage the total usage 
time is of the time the task was in memory. For 
example, if the previous task was in memory for one 
second the percentage of resident time spent using the 
disk was 140ms/1000ms *100% = 14%. 
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@ Interval Statistics 


The statistical nature of the usage time is of key 
importance. 


The metrics defined for interval statistics are: 
- Minimum interval 
- Mean (average) interval 
- Maximum interval 
- Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


The coefficient of variation is of particular impor- 
tance because it tells whether the data is clustered 
about the mean (small c.v.) or widely scattered about 
the mean (large c.v.). In fact, if the c.v. is large, 
the mean may tell very little about the nature of the 
data, since very small values and very large values 
may combine to produce a mean which is not represen- 
tative of any real value. 


1.6 SYSTEM METRICS 


The task workload metrics defined above are useful for deter- 
mining who is using the system resources and how much each user 
is consuming. 


Also of importance is the performance of the system as a whole. 
To this purpose we define a set of system metrics. 


The system metrics vary as a function of time. To see how a 
given system metric varies with time, histograms are computed 
for the metric. Each histogram describes the per cent usage of 
a resource for one sampling interval. The sampling interval is 
a settable parameter described in Chapter 3, section 3.2.1. 
CPU 
The CPU can be in one of three general states: 

® User 

@ Kernel (system) 


@ Idle 
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A useful metric is the per cent of time spent in each state, 
that. 76: 


@ % time in user state 
r) % time in kernel state 
@ % time in idle state 


This gives us a general picture of how effectively the CPU is 
being utilized (% time in user state + % time in kernel state), 
as well as the overhead imposed by the operating system (% time 
in kernel state). 


Memory 


On RSX-11M the memory space is divided into partitions. The 
user can select one system-controlled partition for monitoring 
by SPM-11M. The performance monitor will compute the per cent 
of the partition that was in use at the end of each sampling 
interval and print a histogram. 


The user will most commonly select the partition "GEN" for 
monitoring. 


1/0 Devices 


The user can select one I/0 device to be monitored by SPM-11M 
for system-wide usage. SPM-11M will compute the percent of 
time the device was utilized for each sampling interval and 
print a histogram. If the device is mounted Files-11, SPM-11M 
will compute the percent disk space used at the end of each 
sampling interval and print a histogram. 


Pool 


The RSX-11M system pool contains the dynamically allocated data 
structures used by the executive. SPM-11M will compute the per 
cent of pool that was in use at the end of each sampling 
interval and print a histogram. 


Checkpoint file(s) 


SPM-11M will monitor checkpoint files allocated by the ACS 
command. The performance monitor will compute the per cent of 
all active checkpoint file space in use at the end of each 
sampling interval and print a histogram. 
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Chapter 2 
THE COMPONENTS 
OF SPM-11M 


The SPM-11M performance monitor consists of two main compo- 
nents: the Data Collection Component and the Data Reduction 
Component. The Data Collection Component records the resource 
usage events of the operating system to a logfile; the Data 
Reduction Component reads the logfile and produces a perfor- 
mance report suitable for analysis. 


This general architecture is depicted in Figure 1. 


RSX-11M 


Se 


Data 
LogFile | ———g | Reduction | ——<-g» | Performance 
Component Component Report 


Figure l 
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By decoupling the Data Collection Component from the Data 
Reduction Component in time, the performance monitor can 


collect detailed information about a huge number of events, 
albeit in a raw format. The Data Reduction Component can then 
be used to selectively analyze and filter the information in 
the logfile to produce a performance report. This architecture 
shifts the computational aspects of the performance monitor 
from the Data Collection Component to the Data Reduction 
Component. The benefit derived is that the performance monitor 
uses less CPU time, thus minimizing its interference with the 
CPU. The cost is more I/0 activity, which in most systems can 
be directed to a secondary mass storage device not in the path 
of the major stream of I/0 activity. 
2.1 DATA COLLECTION COMPONENT 
The Data Collection Component consists of both software and 
hardware distributed in various places within an RSX-11M 
system. 
The basic pieces of the Data Collection Component are: 

® Hooks 

® Hook Dispatcher 

@ Hook Routines 

@ Hook Records 

® KW11-P Clock and Handler 

@ Hook Buffers 

@ Logfile 

® Data Collection Task: («ss 60) 

8 Termination Task (...TRM) 


@ COL Message Task (COLMSG) 


The relationship between these pieces is shown in Figure 2. 
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DATA COLLECTION COMPONENT 


Hook 
Dispatcher 
KW11=-P 
Handler 


' COL TASK 


Hook 
Routines 


BUFFER 
PARTITION 


Figure 2 


Heuristic Procedure for Data Collection 
At this point a heuristic procedure for data collection will be 


given, although the terms used in the procedure have not been 
precisely defined. 
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When a resource usage event occurs in RSX-11M, the corre- 
sponding hook calls the hook dispatcher, which uses the hook ID 
to call the appropriate hook routine. The hook routine 
collects information relevant to the hook and assembles it into 
a hook record, which resides in a hook buffer. When a hook 
buffer is filled with hook records, it is written to the 
logfile. The logfile is closed at the end of the measurement 
interval, and subsequently reopened by the Data Reduction 
Component. It reads the hook records and uses them to derive 
the resource usage metrics and print a performance report. 


The details of these pieces will now be developed more fully. 


2.1.1 Hooks 


A hook is simply an implementation technique for capturing a 
resource usage event. For SPM-11M, a hook is implemented as a 
subroutine call inserted at the point in the operating system 
where the event occurs. The subroutine call passes control and 
One argument, the hook ID, to the hook dispatcher. The form of 
an SPM-11M hook is as follows: 


CALL @$HKDSP 
WORD H$XXXX 


where XXXX is mnemonic identifying the particular hook. A 
complete specification of all hooks is given in Appendix A. 


Lelke@ Hook Dispatcher 


Hooks are resident within the operating system; their method of 
insertion is addressed in Chapter 3, section 3.1.3. However, 
most of the code and database for the Data Collection Component 
is not resident within the RSX-11M executive. 


The bulk of the data collection code is resident in the data 
collection task called COL (taskname is ...COL). The chief 
benefit derived from this design is that only a small amount of 
executive space (which translates directly to the critical 
resource: pool) is used by the performance monitor. 


The purpose of the hook dispatcher is to map and call the hook 
routines which are resident in the COL task. Note that, though 
the hook routines are resident in the task partition for COL, 
they are executed in the context of a directive or interrupt 
service routine. The hook dispatcher is resident in pool, is 
allocated when COL is activated, and is deallocated when COL 
exits. The hook dispatcher is analagous to an ICB for a 
loadable driver. 
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A one word dispatch vector labelled $HKDSP is added to system 
common (SYSCM). This word points to the entry point in the 
hook dispatcher resident in pool. It is the port through which 
all hooks pass control from, the RSX-11M executive to the Data 
Collection Component of the performance monitor. 


2.1.3 Hook Routine 


A hook routine copies information which is generally scattered 
about the executive (typically in SYSCM or SYSTB) into a hook 
record which is resident in a static common or dynamic region. 
A timestamp is also recorded in the hook record. 


There are two general types of hooks: task and system. The 
task hooks collect data relevant to resources used by tasks; 


the system hooks collect data which is system-wide (e.g., % CPU 
time in user, kernel and idle). 


2.1.4 Hook Record 
The information collected at each hook is formatted into a hook 
record. The hook record provides an identical representation 


of a hook's information content both in memory and in the 
logfile. 


Each hook record contains both generic and hook-specific data. 
Generic data applies to all hooks. Generic data consists of: 


@ Hook ID 

® Taskname 

® Timestamp 

@ Task's TI (UCB address) 
Hook specific data applies to only one or a small subset of the 
hooks. For example, the H$CDRP (call directive processor) hook 


records the directive ID code as hook-specific data. 


Appendix A specifies the information content of the hook 
records. 
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2.1.5 KW11-P Clock and Handler 


For precise performance measurements, SPM-11M needs a_ high 
speed clock running independent of the RSX-11M system clock. 
It is therefore a requirement that a KW11-P clock be installed 
on a machine running SPM-11M. This KW11-P clock must be in 
addition to the RSX-11M system clock, be it a KW11-L or KW11-P. 


The KW11-P is initialized by the COL task to run at 100 kHz 
(10 microsecond ticks) and to interrupt every 65536 ticks 


(approximately every 0.65 second). 


The KW11-P clock time is maintained as as 2 word (32 bit) value 
which, at a rate of 100 kHz, will overflow in a little over 8 
hours. 


To preclude the possibility of overflow of the KW11-P clock 
time, a maximum measurement interval of 8 hours has been 
established. The task COL enforces this by setting an 8 hour 
mark-time when activated. If the timer expires, COL will stop 
data collection and exit. 


The COL task allocates a piece of system pool and links it to 
the KW11-P clock vector. This pool node serves as the clock 
interrupt handler, which updates the high order clock time 
located in SYSCM at $PCLKH. The low order clock time is not 
stored in memory; rather, each hook routine copies the current 
contents of the KW11-P clock's count register to the _ hook 
record directly to get the low order time word. 


2.1.6 Hook Buffer 


Hook records are stored in buffers which are resident in either 
a static common or a dynamic region. When a hook buffer is 
full, the hook routine sets an event flag which signals the COL 
task to write the buffer to the logfile. 


The hook buffers are linked together into a circular list. 
There may be from 2 to 8 buffers in a list, and all the buffers 
must be of the same length. A buffer may be from 256 words to 
4096 words long. 


If the buffers are resident in a static common, the maximum 
size common which can be used is 4096 words. This limitation 
is imposed because the COL task uses one APR to map the static 
common. 


If the buffers are resident in a dynamic region, the region can 
be from 256 words to 32K words long. 
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Zeded Logfile 
The logfile contains four types of records: 
8 Monitor Parameter Block (MPB) 
6 Information Records 
® Hook Records 
8 System Metric Records 


See Appendix E for a specification of the logfile. 


Monitor Parameter Block 


The Monitor Parameter Block (MPB) is used by the COL task to 
initialize its measurement parameters. The MPB is formatted as 
an Information Record with record type I$MPB. A detailed 
description of the MPB is given in Appendix B. 


The MPB is generated by a command file called SMPGEN.CMD. See 
Chapter 3, section 3.2.1 for details. 
Information Records 
The Information Records are used to supplement the Hook Records 
in the logfile with system context useful to the Data Reduction 
Component. 
When COL starts up it reads the MPB from the MPB file and 
writes it to the logfile. Following the MPB, COL writes a 
stream of Information Records which contain a number of RSX-11M 
data structures defining the initial system state. These data 
structures are: 

e Task Control Block (TCB) 

® Partition Control Block (PCB) 

e Device Control Block (DCB) 

@ Unit Control Block (UCB) 
Each data structure is copied to a separate Information Record. 
When COL begins a measurement interval (starts data collec- 


tion), it records the RSX-11M system time as well as the 
SPM-11M time (KW11-P time) to an Information Record (I$TMR). 
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When COL ends a measurement interval (stops data collection) it 
copies the RSX-11M system time, SPM-11M time, CPU time accrued 
in kernel state and CPU time accrued in idle state to an 
Information Record (I$STM). 


A complete specification of all Information Records is given in 
Appendix C. 


Hook Records 


As each hook point is encountered in the executive, a Hook 
Record is written to the logfile. See section 2.1.4 for 
details. 


System Metrics Record 


At the end of each. sample interval, a System Metrics Record is 
written to the logfile. This record contains information which 
describes the system-wide usage of the selected resources. 


The System Metrics Record is specified in Appendix D. 


Logfile Media 


The logfile can be resident on disk as a Files-11 file or on 
magtape as a sequence of tape records. 


If the logfile is resident on disk, it consists of a sequence 
of virtual blocks (virtual block=256 words). The records 
within these virtual blocks are defined according to the record 
definitions for the MPB, Information Records, Hook Records and 
System Metric Records. Note that the logfile does not have any 
other record structure (such as FCS or RMS type records). 


If the logfile is on a magtape, the MPB, Information Records 
and Hook Records are imbedded in a stream of tape records. 
Each tape record is equal in length to a hook buffer. 


2eled Data Collection Task (...COL) 


This section gives a functional description of the COL task. A 
guide to using COL is provided in Chapter 3, section 3.2.2. 


As noted before, this task contains both code which executes in 
executive context (as a directive or interrupt process) and 
code which executes in the context of a privileged task. The 
code which executes at executive level is the hook routines. 


7/81 THE COMPONENTS OF SPM-11M 2-8 


2.1.8.1 COL Executive Level Code - 


The hook routines were made a part of the COL task for a number 
of reasons: _ 


® They must be resident in some partition outside of 
executive space. 


8 They can easily be loaded as part of the COL task. 
6 They implement routines which are common to hooks and 
to the COL task. 
Ziel wow’ COL Task Level Code - 


Most of the COL task consists of code which is executed at task 
level. The major functions of the COL task are: 


e Initialization 

@ Starting data collection 
@ Writing to logfile 

@ Stopping data collection 


e Cleanup 


Zeleteew sd Initialization - 

When COL begins execution, there is very little SPM-11M code 
elsewhere in the system. All that exists are the hooks in the 
executive which all call a dummy return subroutine in SYSXT. 
It is the job of COL to initialize all code and databases 
required for the SPM-11M performance monitor. The specific 
sequence of initialization functions performed by COL are: 


@ Read MPB file and store MPB in COL buffer. 


e Create dynamic region (if necessary) and set up ring 
of hook buffers. 


e Write MPB and Information Records (RSX-11M data 
structures) to logfile. 


® Mark COL task as fixed in memory and nonshufflable. 


8 Initialize hooks specified in MPB. 
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® Allocate pool node for hook dispatcher and copy code 
to pool node. 


@ Allocate pool node for KW11-P clock handler and copy 
- code to pool node. Link pool node to KW11-P clock 
vector. 


® Initialize KW11-P clock and turn it on. 


6 Initialize measurement parameters as specified in MPB. 


2uleBaeled Starting Data Collection - 


When data collection is disabled, the hook dispatch vector 
$HKDSP points to a dummy routine in SYSXT which simply steps 
over the hook ID and returns to the instruction in the 
executive following the hook. 


Just prior to starting data collection, COL writes a "start 
data collection" Information Record (I$TMR) to the hook buffer. 


To enable data collection the COL task simply points the hook 
dispatch vector $HKDSP to the hook dispatcher code resident in 
pool. 


ely 84-243 Writing Hook Records to Logfile - 


The steady state function of the COL task is to write Hook 
Records to the logfile. When a hook routine fills a _ hook 
buffer, it sets an event flag for COL which wakes COL from its 
wait state. COL then writes the hook buffer to disk or magtape 
(waiting for completion of the write), and loops to see if 
another hook buffer is ready to write. When no more hook 
buffers are outstanding, COL returns to the wait state. 


If the hook buffers fill up too rapidly for COL to write them 
to the logfile, COL will set the overflow status bit. If the 
overflow status is set when a measurement interval expires, COL 
will print a status message on the console device (CO:). In 
general, the data collected during a measurement interval 
should not be used for data reduction if the overflow condition 
occurred. 


Cele et ot Stopping Data Collection - 


To stop data collection, COL merely points the hook dispatch 
vector $HKDSP to the dummy routine at $HKEXT in SYSXT. It then 
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writes a stop data collection Information Record (I$STM) to the 
hook buffer. Any outstanding records in the hook buffer will 
be written to the logfile. 


261086255 Cleanup - 


Before COL exits, it must release any system resources it has 
allocated and deactivate any hardware it has turned on. The 
following actions are thus performed: 


@ Turn off KW11-P clock. 


® Deallocate pool nodes for hook dispatcher and KW11-P 
clock handler. 


® Unfix COL task. 


2.1.9 Termination Task (...TRM) 


The purpose of the termination task (...TRM) is to signal the 
COL task to stop data collection and exit. TRM provides a way 
to manually terminate the COL task, as opposed to automatic 
shutoff by timeout or buffers (see Chapter 3, section 3.2.1). 


Oe lee kO COL Message Task (COLMSG) 


The COL message task contains the ASCII text for the error 
messages issued by the COL task. If the COLMSG task is instal- 
led and a COL error occurs, the full error message text will be 
printed. If a COL error occurs and the COLMSG task is not 
installed, the COL task will print an error number which can be 
correlated with the correct error message in Chapter 3, section 
Sales 


Zee DATA REDUCTION COMPONENT 

The main purpose of the Data Reduction Component is to read the 
raw data from the logfile (hook records) and produce a perfor- 
mance report detailing the resources used by the various tasks 
in the system. 


The Data Reduction Component accomplishes this in a multi-step 
process involving two tasks: 


& Monitor Data Reduction (MDR) Task 


@ DRS Task 


T/S3 THE COMPONENTS OF SPM-11M 2-11 


There are three major steps in the data reduction process: 
1. Map Hook Records to Task Workload Records and generate 
system-wide metrics section of performance report (MDR 
Pass 1). 
2. Sort Task Workload Records (DRS). 
3. Summarize Task Workload Records and generate task 
metrics section of performance report (MDR Pass ee 


The Task Workload Records are intermediate data structures 
which contain the data collected for each task and each 
resource used by the task. 


This general procedure is depicted in Figure 3. 


DATA REDUCTION COMPONENT 
TRACE .LOG 
ook 
0° 
=] P= | | RESOURCE. SRT 
ane oe —P» 


Performance 
RESOURCE. SRT 2 » Report 


Figure 3 


RESOURCE, TMP 


Task Workload 
Record 
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From the figure we see there are four databases which are 
processed by the two tasks: 


8 TRACE.LOG (logfile containing Hook Records). 


6 RESOURCE.TMP (intermediate file containing unsorted 
Task Workload Records). 


@ RESOURCE.SRT (intermediate file containing sorted Task 
Workload Records. 


8 REDUCE.RPT (final performance report). 


2.2.1 MDR Pass 1 


MDR reads hook records from the logfile (default name is 
TRACE.LOG) and maps the information to the Task Workload 
Records in the intermediate file RESOURCE.TMP. 


Qe Lek DRS Pass 


DRS sorts the Task Workload Records using the following three 
keys: 


) Generic Taskname 
@ Task's TI UCB address 


@ Task start time. 


NOTE: By “generic taskname" we mean the installed taskname of 
a multiuser task. For example, the generic taskname for 
the task PIPTS is ...PIP. If the task is not multiuser, 
generic taskname is simply the run time taskname. 


The three keys listed above are concatenated into one “Tg: 
key, with the generic taskname forming the highest order part 
of the key, the Task's TI UCB address forming the middle order 
part of the key, and the Task start time forming the low order 
part of the key. The DRS task sorts all the Task Workload 
Records using this one big key. With this technique the DRS 
task only needs to do one sort operation on the file 
RESOURCE.TMP. 
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When DRS is done sorting the Task Workload Records, the records 
will be arranged as follows: 


8 All records with the same generic taskname will be 
clustered together. 


e Within a generic taskname cluster, all records with 
the same TI will be clustered together. 


@ All records within a taskname-TI cluster will be 
sequenced by ascending task start time. 


DRS writes the sorted Task Workload Records to the file 
RESOURCE.SRT. 

28263 MDR Pass 2 

MDR reads the Task Workload Records from RESOURCE.SRT and 


generates a performance report. A description of the 
performance report is given in Chapter 5. 
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- Chapter 3 
GUIDE TO USING 
SPM-—11M 


3.1 INSTALLATION 


cee! SPM-11M Kit. 


_The SPM-11M kit is distributed on 800 BPI magtape. It contains 
all the files necessary to install and use SPM-11M. The files 
are in DOS tape format. When copied to disk, the files will 
occupy approximately 800 disk blocks. 


The command file PMONCPY.CMD can be used to copy the kit files 
from tape to tape, tape to disk, disk to tape or disk to disk. 
All files are contained in the directory (11,2]. The contents 
of the kit are: 


Component File 

Kit copy command file PMONCPY.CMD 
SPM-11M mini-reference guide SPM.DOC 

MPB GEN command file SMPGEN.CMD 
Macro definition prefix file HKMAC.MAC 
Executive source correction command file PMONSLP.CMD 
Executive source correction files * COR 
FLIACP patch command file PMONPAT.CMD 
FIIACP patch source DISPAT.PAT 
COL/TRM build command file PMONBLD.CMD 
COL overlay descriptor file COLBLD.ODL 
COL/TRM object library COL.OLB 

MDR object library (EIS version) MDREIS.OLB 
MDR object library (FPP version) MDRFPP.OLB 
MDR/CLF build command file MDRTKB.CMD 
Data reduction sort task DRS=ISK 

DRS map file DRS.MAP 

DRS sort command file DRS.CMD 

CLF task CLF «TSK 

CLF map file CLF.MAP 
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Prerequisites to Installing SPM-11M 


COL Prerequisites 


The following are the prerequisites for running the COL task: 


Mapped System 


SPM-11M can only be installed on a mapped RSX-11M 
system. 


Get Partition Parameters Directive 

The COL task will only work if support for the Get 
Partition Parameters (GPRT$) directive is generated 
into the executive. 

AST Support 


The COL task will collect System Metrics only if AST 
Support is generated into the executive. 


Send and Receive 


The COL task will issue full ASCII error message text 
via the error message task COLMSG if support for Send 
and Receive is generated into the executive. 


PLAS Support 


If PLAS support is not generated into the executive, 
the COL task buffering is limited to a maximum of a 4K 
word static common. 


If PLAS support is generated into the executive, the 
COL task buffering may be in a dynamic region up to 
32K words long. 


MDR Prerequisites 


MDR requires the following features of the system where it is 


run: 


7/81 


EIS instructions 


support for the executive directives:  ASTX$, EXTK$, 
GPRI$« GTSK$. 


checkpointing to a dynamically allocated system 
checkpoint file. 


GUIDE TO USING SPM-11M 3-2 


ea ae) 


any features needed by the SYSLIB routines CSI$, 
GCML$, and FCS. 


Installing SPM-11M 


To install SPM-11M, you must start with: 


An RSX-11M V3.2 distribution kit 
An RSX-11M autopatch kit at the current level 


An SPM-11M distribution kit 


To install SPM-11M you must perform an RSX-11M SYSGEN. A 


SYSGEN 


is required because source code for SPM-11M is inserted 


into the RSX-11M sources. SPM-11M source code is added to the 
following RSX-11M source modules: 


SPM-11M Function RSX-11M Modules 


SPM-11M Macros and Definitions RSXMCO,RSXMC 


Hooks DRDSP,DRQIO,DREIF,DREXP, 
DRREG,REQSB,SYSXT,IOSUB, 
LOADR 

Additional Stack Space LOWCR 

Common Database SYSCM 

Dummy Hook Return Routine SYSXT 


The SPM-11M installation procedure consists of the following 


steps: 


T7O1 


Copy RSX-11M V 3.2 kit to baseline disk (labeled 
"RSXM26"). 


Perform autopatch to current level. 
Assign SY: to the "RSXM26" disk. 
Choose a directory to which you want the SPM-11M kit 


files copied. This will be your SPM-11M kit 
directory. 
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T{at 


Assuming the SPM-11M directory is [g,m] 


>SET /UIC=[g,m] 


SUFD: SY.) 


>FLX =ddn:[11,2]PMONCPY.CMD 


>@PMONCPY 


APPLY CORRECTIONS TO EXECUTIVE SOURCES? Y 


& 


APPLY PATCH TO F11ACP DISPATCHER MODULE (DISPAT)?. Y 


@<EOF> 


>@[200,200]SYSGEN 
>@[200,200 ]SYSGEN2 


NOTE: 


If the patch to FIl1ACP fails (checksum error), 
SPM-11M will only calculate service times for 
FI1ACP. If the patch succeeds, SPM-11M will 
generate usage, wait and service times. 


If PLAS is not generated into the executive, 
create a static common up to 4K words long with 
VMR to provide space for the COL buffers. 

If you do not elect to correct the executive 
sources or patch FI1IACP via PMONCPY.CMD you can 
do so later via the command files: 

1) @PMONSLP for executive source corrections 


2) @PMONPAT for F11ACP patch 


When the SYSGEN completes, perform the following 


steps: 


>SET /UIC=[Cg,m] 


>@PMONBLD 
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NOTE: Be sure to taskbuild COL using the baseline 
library [1,1]SYSLIB.OLB (without ANSI or big 
buffering FCS routines). Otherwise COL will be 
greater than 4096 words and will not be able to 
map its buffers via APR6. 


You can build the MDR or CLF tasks separately 


from PMONBLD.CMD by invoking the command file 
MDRTKB.CMD. 


@ You are now ready to run @SMPGEN to generate an MPB 
and run COL. This procedure is described in the next 
section. 


coe 4 OPERATION 


ee Generating the Monitor Parameter Block (MPB) 


The MPB is the structure which contains the measurement 
Parameters. 


To create an MPB you invoke the command file SMPGEN.CMD. 
See Appendix G for an example SMPGEN. 
The procedure is as follows: 
>SET /UIC=[g,m] 
>@SMPGEN 
where [g,m] is your SPM-11M kit directory. 


The MPB is created in the following way: SMPGEN creates a 
source file (default filespec is TRACE.PAR), assembles and 
builds the code in the file to produce a binary MPB file 
(default filespec is TRACE.MPB). It is this file which is read 
by the data collection task COL to initialize the measurement 
parameters. 


In addition to the files mentioned above, SMPGEN also will 
output, if requested, a saved answer file (default filespec is 
TRACE.CMD). This file can be input to another run of SMPGEN 
and will initialize the symbol table to the values of the 
variables saved in the file. 
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SMPGEN is driven from a menu of parameter categories. To 
display the menu, type an <ESC>. The menu appears as: 


; LEGAL PARAMETER CATEGORIES ARE : 
;: HOOK TASK MODE LABEL 
: BUFFER DEVICE SYSTEM DONE 


The parameter categories can be specified in any order. If a 
parameter category is not specified, the parameters will 
receive default values from either: 

@ The saved answer file, if one is specified. 


8 The table of default parameters. 


Table of Default Parameters 
HOOKS - all hooks enabled. 


BUFFERS - DYNAMIC region named TRCPAR created in 
partition GEN, 2 buffers with 8 blocks per 


buffer. 
TASKS - All tasks enabled for data collection. 
DEVICES - All devices enabled for data collection. 
MODE - MANUAL mode. 
SYSTEM - System Metrics enabled with 60 second 
sampling interval. 
LABEL - No label. 


To select a parameter category, enter the name of the parameter 
category desired as shown in the following example: 


ENTER PARAMETER CATEGORY? HOOK 


Once a parameter category is selected, the detailed parameters 
are specified. Each parameter category has a menu of responses 
which are possible for that parameter category. To get the 
menu, type <ESC>. When you are finished entering parameters, 
type "DONE". 


7/81 GUIDE TO USING SPM-11M 3-6 


A detailed description of each parameter category follows. 
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Label Field 


To select the label parameter category, type: LABEL 
The following query will be displayed: 


ENTER MPB LABEL? 


The response may be any string from 0 to 63 characters 
long. This user-definable string is stored in the MPB 
and will typically contain notes and comments appli- 
cable to a particular measurement run. It is printed 


as part of the heading on each page of the performance 
report. 


Hooks 


To select the hooks parameter category, type: HOOK 


The hooks determine which resource usage events are 
recorded to the logfile. 


You do not select each hook individually. Rather, you 
select one or more groups of hooks. Each group of 
hooks contains the subset of hooks which will generate 
a consistent set of data for measuring the usage of a 


particular resource. Hooks may be chosen from the 
following groups: 
- CPU USAGE HOOKS 

This hook group measures task CPU usage. 

It is required for all metrics for task CPU usage. 
- MEMORY USAGE HOOKS 


This hook group measures task memory usage. 


It is required for all metrics for task memory 
usage and % resident time. 


- 1/0 DEVICE USAGE HOOKS 
This hook group measures task usage of I/0 devices 
and the file system. The file system is regarded 


as any ACP which manages a device. Examples are 
FIIACP and MTAACP. 
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This hook group is required for all metrics 
relative to task usage of I/0 devices or the file 
system. 


Buffers 


To select the buffers parameter category, type: 
BUFFER. 


The hook buffers may be resident in either a static 
common or a dynamic region. The buffer type is 
specified by: 

ENTER BUFFER TYPE? 


The response may be either STATIC indicating a static 
common or DYNAMIC indicating a dynamic region. 


NOTE: If "STATIC" is selected, the COL task must have 
been linked to a static common in the instal- 
lation phase (see Chapter 3, section 3.1.3). 

If "DYNAMIC" is selected, COL must not be linked 
to the static common. 


If the buffer type is DYNAMIC, the name of the 
System-controlled partition in which to create the 
dynamic region is specified by: 
ENTER NAME OF BUFFER MAIN (SYS) PARTITION? 
The name of the buffer common/region is specified by: 
ENTER NAME OF BUFFER COMMON/REGION? 


The partition will be divided up into a number of hook 
buffers, determined by: 


ENTER NUMBER OF BUFFERS [2.:8.:2.]? 
Note that from 2 to 8 buffers may be specified. 
Finally, the length of each buffer is specified by: 
ENTER BUFFER SIZE IN 512 B..BLOCKS? 


A buffer can be from 1 to 16 blocks long; in other 
words, from 256 words to 4096 words long. 
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If a static common is used for buffering, the total 
space required for buffers must fit into the common. 
If a dynamic region is used, COL will create a region 
large enough to contain the buffers. 


Tasks 


SPM-11M can be set up to collect data for specific 
tasks. For example, there may be some tasks whose 


performance metrics are not desired at all. 
Typically, system "service" tasks, such as FI11ACP, 
«+-MCR and QMG... fall into this category. 
To select the task parameter category, type: TASK. 
The following query will appear: 

DO YOU WANT TO TRACE ALL TASKS? 


If your answer is N, you will be given two choices for 
selecting the tasks for data collection: 


- Specify the tasks not to trace. 
- Specify the tasks to trace. 
The choice is made from the query: 
DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? 
If the answer is Y, you are prompted with: 
ENTER NAME OF TASK NOT TO TRACE? 
If the answer is N, you are prompted with: 
ENTER NAME OF TASK TO TRACE? 
You then type, one per line, the names of the tasks 
desired or not desired. Each taskname is from 1 to 6 
characters long. To terminate the list of tasks, type 


<CR>. 


Up to 64 tasknames can be specified. 


Devices 


To get the devices parameter category, type: DEVICE. 
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SPM-11M can be set up to collect data for specific 
classes of devices. If you want to collect data only 
for selected classes of devices, answer N to the 
following query: 

DO YOU WANT TO COLLECT DATA FOR ALL DEVICES? 
A device in RSX-11M may fall into one of four classes 
depending on the bit setting of the "Device Character- 
istics Word" U.CWl in the UCB. 
- Directory Device (DV.DIR) 
- Sequential Device (DV.SQD) 
- Terminal Device (DV.TTY) 
- All Other Devices 


To enable data collection for a device class, answer Y 
to the query for that device class. The queries are: 


TRACE DISK (DIRECTORY DEVICE) I/0 ACTIVITY? 
TRACE TAPE (SEQUENTIAL DEVICE) I/0 ACTIVITY? 
TRACE TERMINAL 1/0 ACTIVITY? 

TRACE ALES OTHER: DEVICES: 1/0: ACTIVIEY ? 


Mode 

To select the mode parameter category, type: MODE. 

The performance monitor can be set up to collect data 
in three different modes. You select the mode by 
answering: 


ENTER MODE? 


The possible modes are: MANUAL, AUTOSTOP and REPEAT. 
Each mode determines the manner in which a measurement 


interval begins and ends. A description of each mode 
follows: 


- Manual 
In manual mode, a measurement interval begins when 


the COL task is invoked and ends when the TRM 
(termination) task is run. 
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Autostop 
In autostop mode, a measurement interval begins 
when the COL task is invoked and ends when either 
of the following two events occur: 

A mark-time expires. 


A predetermined number of buffers have been 
filled. 


You determine the type of autostop by responding 
to: 


ENTER SAMPLING TYPE? 
with either TIME or BUFFER. 


If TIME is specified, you then have to specify the 
timeout interval: 


ENTER SAMPLING INTERVAL TIME UNIT [D:MIN] 
ENTER SAMPLING INTERVAL IN units ? 


where “units" is the time unit specified in the 
previous query. Legal units are SEC, MIN or HR. 


NOTE: Do not confuse this sampling interval with 


the system metrics sampling interval 
described in the next section. 


If BUFFER is specified as the interval type, you 
must specify the number of buffers per sample: 
ENTER NUMBER OF BUFFERS PER SAMPLE? 


Note that each buffer is from 1 to 16 disk blocks 
(256 words) long. 


Repeat 

Repeat mode is autostop mode repeated a number of 
times. The sampling interval is specified as for 
autostop mode. In addition, you must specify: 


The number of intervals 


The length of time between intervals. 
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You specify these parameters by answering the 
following queries: 


ENTER MAX. NUMBER OF SAMPLES? 
ENTER INTERVAL BETWEEN SAMPLES TIME UNIT [D:MIN]? 
ENTER INTERVAL BETWEEN SAMPLES IN units ? 
where "units" is the time unit specified in the 
previous query. 

6 System 


To select the system-metrics parameter group, type 
gas Oe ae 


If you want the system metrics, answer Y the the next 
query: 


DO YOU WANT THE SYSTEM METRICS? [Y/N]: 


If you answered Y, you must then specify the sampling 
interval by: 


ENTER SYSTEM METRICS SAMPLING INTERVAL (SEC) ? 


® Done 


When you are finished entering parameters, type 
"DONE". The SMPGEN procedure will then create: 


- A monitor parameter block (MPB) file 
(filename.MPB). 


- A parameter source file (filename.PAR). 
- A saved answer file (filename.CMD, if specified). 
Note: SMPGEN will prompt you for the parameter source 


file and saved answer file, and you must enter 
a valid file specification. 
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DeLee Using COL 


The COL task is used to initialize the performance monitor, 
Start data collection, collect data, stop data collection and 


clean up the performance monitor before exiting. 


Installing COL 


The COL task can be installed in any partition. If possible, 
create a separate 4K word partition for COL. If installed in a 
System-controlled partition, COL will automatically fix itself 
and mark itself as non-shufflable. It is therefore desirable 
to install and run COL when there is little or no system 
activity in the partition in which COL is installed so as to 
load COL in the lower end of the partition and reduce fragmen- 
tation of the partition. The COL task will occupy approxi- 
mately 4K words of memory. 


COL is taskbuilt with a default priority of 230. Note that COL 
‘has a higher priority than F11ACP and ...MCR, but a lower pri- 
Ority than ...LDR. It is highly recommended that the priority 
of COL not be altered to a value lower than the default value 
of 230, otherwise excessive overflows may occur which will 
invalidate the measurement runs. 


If full ASCII message text output is desired, install the 
COLMSG task. 


If you are using a static common for COL buffers, be sure to 
install it before installing the COL task. 


Install COL and COLMSG by: 
>INS TRCPAR ;ONLY FOR STATIC COMMON 
>INS COL 
>INS COLMSG 


Running COL 
To run COL, type a command line of the form: 
>9COL logfile/sw=MPBfile/sw 


The default logfile specification is S¥:[cur _uic]TRACE.LOG. 
The default MPBfile specification is SY¥:[Lcur uic]TRACE.MPB. 
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Stopping COL 
There are two ways to terminate COL: 
® RUN TRM 
@ Specify AUTOSTOP or REPEAT mode in SMPGEN. 


RUN TRM will terminate COL regardless of the mode in which COL 
is running: MANUAL, AUTOSTOP or REPEAT. 


COL will also terminate if any of the following abnormal 
conditions are detected: 


8g Powerfail recovery 
In this case, if powerfail recovery support is 
included in the executive, COL will issue a SPRA$ 
directive. Upon powerfail recovery, COL will simply 
exit. 

@ Write errors 
If COL detects write errors, it will print a message 
and exit. Write errors will generally corrupt the 
logfile with invalid data. 


@ Automatic 8-hour termination. 
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COL Switches 


Switch defaults -- 


Output; SY¥:TRACE.LOG/DENS:800/EX:100./1F2100./W1:10. 
Input: SY: TRACE.MPB/BF:2:8/DL:0/DV:LBO/PR: GEN 


/AP Append records to end of magtape. COL will 
Space over all existing files on the magtape 
and append the records for this run starting 
at the current end-of-volume point. 


/DENS:density Set tape density to 800 or 1600 bpi. 


/EX:n Specifies disk file extent size in 256W 


blocks. 


JLESn Specifies disk file initial size in 256W 


blocks. 


/WI:n Specifies number of retrieval pointers in 


window block. 


/BFim:n Number of buffers = m ; size of buffer = n 


256W blocks. 


/DLin Number of MINUTES COL delays before it 


starts data collection. 


/DV:ddnn Device selected for system metrics. 


/PR:parnam Partition selected for system metrics. 


/TIl:nn 


Collect data only for tasks with TI of TTnn. 
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Example 1 
>COL DB2:[3, 300 ]CPUTEST/IF:1000/EX: 200=DB1:[5, 200 ]PARM1/DV:DB2: 


logfile is DB2:[3,300]JCPUTEST.LOG with initial size 1000 and 
extent size 200. 


MPB file is DB1:[5,200]PARM1.MPB with system metrics specified 
for DB2. 


Example 2 
>COL MM1:/DENS:1600=DB1:[5,200]SAMPLE .MPB 


logfile is_on MMl: in 1600 BPI; MPB file is 
DB1:[£5,200]SAMPLE.MPB. 


Example 3 
>COL = 


logfile is SY¥:[current uic]TRACE.LOG; MPB file is SY:[current 
uic]TRACE.MPB. 


NOTE: You cannot run COL with a null command line, i.e, COL 
<CR>. The COL task expects to see explicit filespecs or a 
bare "=" indicating defaults on both input and output. More- 
over, you cannot invoke COL with a command of the form: 


>RUN COL 


Since no filespecs can be specified with this form. One final 
thought in this regard: only one copy of COL can be active in 
the system at a time. If multiple invocations of COL are 
attempted at different terminals, all but the first will be 
rejected with an error message "MONITORING ACTIVITY IN 
PROGRESS". 


Once COL is activated, it will run in the mode specified in the 
MPB but always for a maximum of 8 hours. This time limit is 
imposed because the KW11-P clock time will overflow in a little 
over 8 hours. 
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COL Messages 


COL outputs two types of messages: error messages and status 
messages. 


Full ASCII error message text will be printed only if__the 
COLMSG task is installed. If the COLMSG task is not installed, 


COL will print a message of the form “COL ERROR XXXXXX", where 
XXXXXX is the error number. The error messages are listed by 
error number in the following list. Error messages are issued 
if an error condition occurs while COL is starting up and 
initializing the performance monitor. Error messages are 
Output to the terminal of issue (TI:) for COL. 


Status messages are issued while COL is running in steady 
State. There are status messages for both normal and error 
conditions. Status messages are issued to the console terminal 
(CO:). The COLMSG task does not have to be installed to get 


the status messages; as they are printed directly by the COL 
task. 


COL Error Messages 
000000 COLMSG -- XXXXXX (DSW) GET COMMAND LINE ERROR 


Explanation: A "Get MCR Command Line" directive failure 
occurred. 


User Action: Reenter COL command line using correct 
form. 
NOTE: Illegal command forms are: 

le. 2COL <GR> 

2. >RUN $COL <CR> 


Legal command line forms are: 


1. >COL filespec/sw 


filespec/sw 


2. COL filespec/sw 


ul 


/SW 


Be - 2COL 


filespec/sw 


4. >COL 
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000001 


000002 


000003 


000004 


000005 


000006 


000007 
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COLMSG -- COMMAND SYNTAX ERROR 

Explanation: Entered incorrect syntax for command line. 
User Action: Reenter command line with correct syntax. 
COLMSG -- MPB FILENAME SYNTAX ERROR 

Explanation: Entered incorrect syntax for MPB filename. 
User Action: Reenter MPB filename using correct syntax. 
COLMSG -- XXXXXX (FCS) MPB FILE ACCESS FAILURE 


Explanation: COL failed to open MPB file or received a 
read error when attempting to read the MPB file. The 


code XXXXXX (FCS) indicates the FCS error code returned 
LosCOL. 


User Action: Check that specified MPB file exists, the 
volume is mounted (if disk), or that the file protection 
does not prevent COL from reading the MPB. 
COLMSG -- XXXXXX (DSW) ASSIGN LUN FAILURE 


Explanation: COL failed to assign a LUN to the logfile 
device. 


User Action: Check that the device specified for 
logfile is in the system configuration. 


COLMSG -- ILLEGAL LOGFILE DEVICE TYPE 

Explanation: The device specified for the logfile is 
not of the correct type. Valid logfile device types 
are: Directory structured (disk, DECTAPE), or Sequential 
(magtape). 


User Action: Specify a device which is either directory 
structured or sequential. 


COLMSG -- LOG FILENAME SYNTAX ERROR 
Explanation: Entered incorrect syntax for logfile. 


User Action: Reenter logfile specification using 
correct syntax. 


COLMSG -- XXXXXX (FCS) LOGFILE ACCESS FAILURE 


Explanation: COL failed to open the logfile. The code 
XXXXXX (FCS) is the FCS error returned to COL. 
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000010 


000011 


000012 


000013 


Tiok 


User Action: Check that the logfile volume is mounted 
and the necessary directory exists (if disk), or the 
volume is online (if magtape). 


COLMSG -- ILLEGAL BUFFER SPECIFIED 


Explanation: The parameters specified by the /BF:n:m 
Switch were not valid. Either the number of buffers (n) 
was out of range (<l or >8) or the buffer size was out 
of range (>16). 


User Action: Respecify a valid buffer count or size via 
the /BF switch. 


COLMSG -- XXXXXX (DSW) BUFFER PARTITION NOT IN SYSTEM 


Explanation: The partition specified in the MPB is not 
in the system. 


User Action: If the buffer partition is a static 
common, check that the static common partition exists 
and that the common is installed. 


COLMSG -- BUFFERS WILL NOT FIT INTO PARTITION 


Explanation: The number of buffer blocks specified in 
the MPB (NUMBER OF BUFFERS * BUFFER SIZE IN 512 B 
BLOCKS) is greater than the number of 512 B blocks in 
the physical buffer partition. 


User Action: Do a SMPGEN and specify the NUMBER OF 
BUFFERS and BUFFER SIZE IN 512 B BLOCKS such that the 
product of the two is less than the number of 512 B 
blocks in the physical buffer partition. 


COLMSG -- XXXXXX (DSW) CANNOT CREATE BUFFER PARTITION OR 
ADDRESS WINDOW 


Explanation: COL received a DSW error when attempting 
to create the dynamic buffer partition specified in the 
MPB, or when attempting to create an address window Loe 
map the dynamic partition. The error XXXXXX (DSW) is 
the DSW error from the Create Region directive or from 
the Create Address Window directive. 


User Action: Che 
partition. tos con 
specified in the MPB. 


that enough space exists in the GEN 
n a dynamic region with the size 


If the error was from a Create Address Window directive, 
check the size of the COL task (look at the map in 
L11,2]COL.MAP) and verify that it is less than or equal 
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to 4096 words. If COL is greater than 4096 words, it 
may have been taskbuilt using a SYSLIB.OLB with ANSI or 
big buffering FCS routines. COL must then be 
re-taskbuilt using a baseline SYSLIB.OLB which contains 
the non-ANSI FCS routines. 


000014 COLMSG -- MONITORING ACTIVITY IN PROGRESS 


Explanation: A multiple invocation of the COL task was 
attempted. Only one copy of COL can be active at a 
time. 


User Action: Do not attempt to run more than one copy 
of COL at a time. 


000015 COLMSG -- INVALID MPB FILE 
fi 


Explanation: The MPB filespec HAE 
va 


d in the COL 
command line’ is not the name of a B ] 


ified ij 
id MPB OFT es 


User Action: Reenter a filespec for a valid MPB file. 
000016 COLMSG -- INFORMATION RECORD ALLOCATION FAILURE 


Explanation: Insufficient space exists in the buffer 
partition to contain all the Information Records. 


User Action: Do a SMPGEN and specify enough blocks 
(NUMBER OF BUFFERS * BUFFER SIZE IN 512 B BLOCKS) to 
contain all the Information Records. The space required 
is roughly that needed to contain the TCBs, PCBs, DCBs, 
and UCBs in the system at the time COL is run. 


000017 COLMSG -- KW1l1-P VECTOR OR CSR UNAVAILABLE 


Explanation: Either the KW11-P vector is in use, or the 
KW11-P CSR is non-existent on the UNIBUS. 


User Action: Check that the correct KW11-P vector and 
CSR were specified in the procedure @PMONBLD.CMD, that 
the vector is not used by another RSX-11M driver or 
task, and that the CSR is addressable on the UNIBUS. 


o 


000020 COLMSG -- CANNOT USE SYSTEM'S KW11-P as SPM-11M CLOCK 


Explanation: The RSX-11M system clock is a KW11-P and 
an attempt was made to use it as the SPM-11M 
(performance monitor) clock. 


User Action: Check that a separate KW11-P was installed 
for use by the SPM-11M software, and that the vector and 
CSR specified in the procedure @PMONBLD.CMD was for this 
Chocks 
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000021 


000022 


000023 


COLMSG -- POOL NODE ALLOCATION FAILURE 


Explanation: COL could not allocate a RSX-11M pool 
node. 
User Action: Re-run COL when sufficient pool is 


available. 
COLMSG -- BUFFER OVERFLOW 


Explanation: COL failed to allocate space for a hook 
record because all buffers were full. 


User Action: Re-run COL, using a larger buffer size 
specified either via SMPGEN.CMD or the /BF switch. 


COLMSG -- PARTITION SPECIFIED NOT IN SYSTEM 


Explanation: The partition specified via the /PR switch 
is not configured in the system. 


User Action: Respecify a partition configured in the 


system. 


000024 


COLMSG -- ILLEGAL DELAY VALUE SPECIFIED 


Explanation: An illegal delay value has been specified 
via the /DL switch. 


User Action: Re-specify a delay value in the correct 
range (0 to 28800). 


COL Status Messages 


COL -- 


COL -- 


£31 


PERFORMANCE MONITOR INITIALIZED 


Explanation: COL has successfully initialized and is 
now ready to collect data. 


User Action: None 

PERFORMANCE MONITOR EXITING 

Explanation: COL has ey data collection. an 
cleaned up its databases. his status message is issu 


by COL immediately prior to exiting. 


User Action: None 
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COL -- CANNOT MAP OUTPUT BUFFER 


Explanation: COL received an error when attempting to 
map to the output buffer using the Map directive. 


User Action: Check that the dynamic region used as the 
output buffer was successfully created. 


COL -- LOGFILE WRITE ERROR 


Explanation: COL received an FCS or QIO error when 
attempting to write to the logfile. 


User Action: Check the integrity of the logfile. Tf 
repeated errors occur to the same logfile, rerun COL to 
create a new disk file or mount a fresh tape. 


COL -- LOGFILE CLOSE ERROR 


Explanation: COL received an error when attempting to 
close the logfile. COL will exit shortly after printing 
this message with the logfile improperly closed. 


User Action: Because the logfile was improperly closed, 
it may be difficult to read the logfile and produce a 
performance report. 


COL -- BUFFER OVERFLOW 


Explanation: Hook records were written to the _ hook 
buffer faster than COL could write them to the logfile. 

User Action: In general, the data collected during a 
measurement interval which overflowed is not usable by 
the MDR task to produce a performance report. An 
attempt should be made to rerun the measurement to 
obtain data without overflow. Prior to attempting 


another measurement run, a SMPGEN should be run with 
larger buffers specified than for the measurement run 
which overflowed. 


Se2 a8 Using TRM 

The TRM task is used to manually signal the COL task to stop 
data collection, cleanup and exit. TRM will cause COL to exit, 
regardless of the mode in which COL was running: manual, 
autostop or repeat. 


TRM is run by the command >RUN TRM. 
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3.2.4 Using MDR 


MDR is used to read the logfile and produce a performance 
report. MDR is used in conjunction with DRS (sorting) task to 


produce the performance report. The general procedure is as 
follows: 


® >RUN MDR 
MDR>LISTFILE/sw=LOGFILE/sw 


MDR will read the command line and execute pas S: is 


When pass 1 completes, MDR will print the following 
message and suspend: 


MDR -- YOU MUST NOW SORT THE INTERMEDIATE FILE BY 
USING. DRS s&ISk 


MDR -- 
>DRS RESOURCE.SRT=RESOURCE.TMP/FO:V:156/KE:1.12/PR:T 


MDR -- es THE SORT HAS COMPLETED, RESUME THIS TASK 
..MDR) 


NOTE: Rather than type the command line to DRS as shown 
above, you can simply invoke the command file @DRS. 


@ >@DRS sorts the intermediate file. 
® >RES MDR 


MDR executes pass 2 and prints the performance report. 


Certain MDR command switches restrict the input data which will 
be processed. If a logfile contains too much activity for MDR 
to reduce the data without running out of space, these switches 
(/AF, /BF, /-MD, /NT, /NU, /TS, /UC) may be used to reduce a 
logfile by successive runs of MDR, analyzing only parts of the 
workload in each run. 


When using the switches /NT, /NU, /TS, or /UC, MDR will prompt 
for the task or device names after the command line is 
processed. The tasknames are specified as 1 to 6 RADS5O 
Characters per entry. Only generic tasknames are used for /NT 
or /TS. The TI device names are entered as "DDnn:", with one 
entry per line. 
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MDR Switches 


Switch defaults -- 
output: SY:REDUCE.RPT/SP 
input: SY:TRACE.LOG/DM:2/L1:2/RW/S1:613/MD/SK:0/DE:800/-IC 


Output Switches Description 


/SP /-SP SPool output file 


I 


| Input Switches 


| 


/AF:PChigh:PClow} Only process records from AFter specified | 

| time | 

| 

/BF:PChigh:PClow] Only process records from BeFore specified 
time 


{ 

i 

/DE:nnnn Select input magtape DEnsity, 800 or 1600 | 
(ignored unless /RW is also used) 


/DM:nn DuMp specified record types: 


O01 - buffer headers 
O02 - unknown record types 
04 - system configuration info records | 
10 - task event hook records 

| 20 - system metric records 

| 40 - user information hook records 


; /1C POG Replace the % resource column of the report | 
with a count of incomplete intervals. 


i /LIinn Detail level of task workload metrics: | 


00 - no report produced 
| Ol - system-wide summary only 
02 - system and task summaries 
| 03 - system, task, and TI: summaries 
04 - all summaries and each complete 
task run 
05 - all summaries and all task invocations 


achat Adena ele ett A 


(continued on next page) 
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/MD /-MD 


A 
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MDR_S 


Report 


witches (continued) 


Input Switches Description 


on tasks with missing data 


Do Not process hooks for listed Tasks 

Do Not process hooks for listed devices as 
TI: 

Produce. System. Contiguration section of 
report 

Selects the contents of Sampling Interval 
report by setting nn to the total for the 
desired items: 

000 - no report produced 

001 - data collection start/stop times 

002 - % CPU usage 

004 - % memory partition usage 

010 - % device time busy 

020 - % device space used 

040 - % POOL used 

100 - % CKPT space used 

200 - clock time of metrics 

400 - trailing blank line after the metrics 


SKip nnn files when opening tape input file 


ReWind 


tape input file before opening 


Process hook records only for listed TaSks 


Process hook records only for listed 
devices as TI: 


witches 


| 


_ 


and /TS are mutually exclusive. 
/NU and /UC are mutually exclusive. 
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MDR Messages 


The MDR messages are issued to the TI device under which MDR 


runs. 


MDR -- 


MDR -- 


MDR -- 


MDR -- 
MDR -- 


MDR -- 
MDR -- 


MDR -- 


{O48 


This section discusses the messages which MDR can issue. 


PLEASE ENTER TASKNAMES ONE AT A TIME FOLLOWING EACH 

WITH A <CRD>. TYPE JUST A <CR> AFTER THE LAST ONE IS 
ENTERED 

TSKNAM> 


Explanation: This is the prompt for the generic task- 
names for filtering by the /NT or /TS switch. The last 
line of this message is repeated for each line of input. 


User Action: Enter generic task name(s). 


PLEASE ENTER TI DEVICES (DDNN:) ONE AT A TIME FOLLOWING 
EACH 

WITH A <CR>. TYPE: UST OA. <CR> APTER THE.“ LAST “ONE. ES 
ENTERED 

TI DEVICE> 


Explanation: This is the prompt for device names to be 
used by the /UC or /NU filter. The last line of this 
message is repeated for each line of input. 


User Action: Enter full device name(s) as "DDnn:". 


YOU MUST NOW SORT THE INTERMEDIATE FILE BY USING DRS.TSK 
(E.G.) MCR>DRS 

RESOURCE.SRT=RESOURCE. TMP/FO:V:156/KE:1.12/PR:T 

AFTER THE SORT HAS COMPLETED, RESUME THIS TASK (TSKNAM) 


Explanation: This message indicates that the first pass 
of MDR has completed. Manual intervention is now 
required to run the DRS task with the given command. 
The task name under which MDR is running is given in 
parenthesis in the last line of the message. 


User Action: Run the DRS task (@DRS.CMD), and when it” 
has completed, resume the MDR task. 


DSW:###### F.ERR:###### I0SB:##44## HHHHHH PC HHHHEE 
SP: ##EHHE 
STK: ##HH#E HHHHHE 


Explanation: This is a status message which gives 


detail of the internal state of MDR at the time when an 
error is detected. This message is always followed by 
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One of the messages discussed below, which describes the 
actual error condition. 


User Action: See action specified for the message 
issued immediately following this status message. 

MDR -- AN INCOMPLETE RESOURCE UTILIZATION REPORT WILL BE 
PRODUCED 
Explanation: An error occurred which prevented the 
completion of pass II of MDR. Although a report will be 
produced, not all task-workload data has been summa- 
rized. A previous error message is issued giving the 
Cause of this condition. 


User Action: As specified for previous message. 


MDR -~- ATTEMPT TO PRINT NULL TWB 


Explanation: An internal inconsistency occurred in the 
pass II processing of MDR. 


User Action: * * * SPR ! 


MDR -- ATTEMPTING TO DEALLOCATE TWB NOT IN TSKHD 


Explanation: An internal inconsistency occurred in the 
pass I processing of MDR. 


User Action: * * * SPR ! 


MDR -- CHECKPOINT USAGE > 100% 


Explanation: A Checkpoint metric indicates more than 
100% usage of the checkpoint space. The metric is not 
reported, 


User Action: Ensure logfile is not corrupted. 


MDR -- CLOCK STOPPED OR HOOK RECORD OUT OF TIME SEQUENCE. 
Explanation: The records in the logfile do not follow a 
strict time sequence. This condition invalidates the 
data in the logfile. 


User Action: Ensure that the KW11-P clock is 
functioning. Re-collect the data. 
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MDR -- 


MDR -- 


MDR -- 


MDR -- 


MDR -- 


MDR -- 
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COMMAND READ ERROR 


Explanation: An I/0 error occurred while attempting to 
read the MDR command line. 


User Action: Reenter the MDR command. 


COMMAND SYNTAX ERROR 


Explanation: The command as entered has improper 
syntax. 


User Action: Reenter the corrected MDR command. 


COMPLETION ERROR IN INPUT READ 

Explanation: An I/0 error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
Symptomatic of a corrupted logfile. 


User Action: Check IOSB for error cause. Rerun MDR 
using another logfile if necessary. 

CONFLICTING SWITCHES /TS+/NT OR /UC+/NU 

Explanation: The switches /TS and /NT were both speci- 
fied, or the switches /UC and /NU were both specified. 
Only one of each pair of switches may be specified. 

User Action: Reenter the command line without both of 
the conflicting switches. 

DEVICE USAGE > 100% 

Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of device utili- 
zation. No graphic output will be produced for the 
suspect record. 


User Action: * * * SPR ! 
DEVICE'S ACP NOT FOUND 


Explanation: The system information records indicated 
that a device was mounted, yet no TCB for the ACP task 
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MDR -- 


MDR -- 


MDR -- 


MDR -- 
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was found. The device may have been dismounted concur- 
rently with COL's scan of the system configuration. A 
generic ACP name will be used for the device's ACP 
functions. 


User Action: None. 


DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass I. 
This indicates a severe shortage of necessary dynamic 
space. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 


ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 

Explanation: An 1/0 error occurred when Seta ae to 
open the logfile on magtape. The drive may have been 
mounted to MTAACP which is incorrect since MDR does QI0s 
directly to the tape device driver. 


User Action: Correct the condition and rerun MDR. 


ERROR CLOSING INPUT FILE 


Explanation: An I/0 error occurred when closing the 
input logfile. 


User Action: None. 


ERROR. CLOSING REPORT FILE 


Explanation: An 1/0 error occurred when closing the 
report file. This file will not be properly closed or 
spooled. 


User Action: Correct the condition and manually close 
the file, or rerun MDR. 
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MDR -- 


MDR -- 


MDR -- 


MDR -- 


MDR -- 


regs 


ERROR CLOSING RESOURCE.TMP FILE 


Explanation: An I/0 error occurred at the end of pass I 
when closing the RESOURCE.TMP file. The DRS task will 


not be able to read this file until it is properly 
closed. 


User Action: Correct the condition and manually close 
the file, or rerun MDR. 


ERROR DELETING RESOURCE. IMP FILE 


Explanation: An 1/0 error occurred when MDR deleted 
its temporary file. The file is not properly closed, or 
deleted. 


User Action: Manually unlock and delete this file. 


ERROR IN GTSK$S 


Explanation: The directive failed preventing MDR from 
obtaining its taskname. The message requesting the sort 
to be run will not include MDR's taskname. 


User Action: None. 


ERROR IN INPUT READ QIO 


Explanation: An 1/0 error occurred while reading the 
logfile. This condition will be treated as end-of-file 
and MDR will attempt to continue. This may be 
symptomatic of a corrupted logfile. 


User Action: Check DSW for error cause. Rerun MDR 
using another logfile if necessary. 


ERROR OPENING RESOURCE.SRT FILE 


Pd 


Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.SRT file for pass II. 
Pass II will not be able to run. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 
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ERROR OPENING RESOURCE.TMP FILE 

Explanation: An error was reported by FCS when MDR 
attempted to open the RESOURCE.TMP file for write in 
pass I. Pass I will not be able to run. 

User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 

ERROR OUTPUTTING PRINT LINE 

Explanation: An error was reported by FCS when MDR 
attempted to output a record to the report file. MDR 
will attempt to continue to produce the report. If this 
error is not caused by a transient condition the message 
will be repeated, and MDR will have to be aborted. 


User Action: Correct the condition and rerun MDR. 


ERROR READING MPB 


Explanation: An I/0 error occurred when attempting to 
read the: Tirst: block of the Togt]1e< 


User Action: Correct the condition and rerun MDR. 


ERROR READING RESOURCE.SRT FILE 

Explanation: An I/0 error occurred in pass II when 
attempting to read from the RESOURCE.SRT file. This 
will be treated as an end-of-file condition. 


User Action: Correct the condition and rerun MDR. 


ERROR REOPENING RESOURCE.TMP FILE 

Explanation: An I/0 error occurred when attempting to 
re-open the RESOURCE.TMP file so it could be deleted. 
The RESOURCE.TMP file will not be deleted. 


User Action: Delete the file manually. 


ERROR SKIPPING OVER MPB BUFFER 
Explanation: An I/0 error occurred when repositioning 


the tape logfile so the MPB could be reread once the 
buffer size is known. 
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User Action: Correct the condition and rerun 


ERROR WRITING RESOURCE.TMP FILE 


Explanation: An 1/0 error was reported by 
write operation during pass I. 


User Action: Correct the condition and rerun 


EXPECTED RIB NOT FOUND 


Explanation: An inconsistency occurred 
internal dynamic data structures. 


User Action: See Chapter 7, Section 7.3. 


EXPECTED RWB PREDECESSOR NOT FOUND IN OVERLAP 


Explanation: An inconsistency occurred 
internal dynamic data structures. 


User Action: * * * SPR ! 


EXPECTED RWB PREDECESSOR NOT FOUND IN MERGE 


Explanation: An inconsistency occurred 
internal dynamic data structures. 


User Action: * * * SPR ! 


[IDLE TIME > 100% 


MDR. 


FCS 


MDR. 


in 


in 


in 


for a 


MDR's 


MDR' Ss 


MDR's 


Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of CPU idle time. No 
graphic output will be produced for the suspect record. 


User Action: S$ée Chapter 7, Section 7 .<5« 


IMPROPER FORMAT OR NO SUCH DEVICE IN SYSTEM. PLEASE 
Reb Pikes 
Explanation: An improper response was entered to the 
prompt for TI filter devices. 
User Action: Enter a corrected response. 
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INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanations An improper command line was used with 
MDR. 


User Action: Reenter the command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with the correct 
density. 

INVALID DEVICE SPACE METRIC RECORDED 

Explanation: A system metric record indicates more than 
100% of device space used. The device Space metric will 
not be reported. This metric is only available for 


devices mounted to F11ACP. 


User Action: Ensure logfile not corrupted. 


INVALID INPUT DEVICE TYPE 


Explanation: An attempt was made to reduce a logfile 
which is not on either a disk or tape volume. MDR can 
only use disk or tape for the input file. 

User Action: Do not use MDR to read logfiles not 
residing on disk or tape. 

INVALID INPUT FILESPEC 

Explanation: A syntax error occurred in the input 


filespec part of the MDR command. 


User Action: Correct and reenter the command. 


INVALID LISTING LEVEL 


Explanation: An invalid listing level was specified in 
the /LI switch. Acceptable values range from 0 to 5. 


User Action: Correct and reenter the command. 
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MDR -- INVALID MPB FOUND BY ALC 
Explanation: The logfile was found to contain improper 
data. This may be a result of using MDR to read a 
logfile produced by an incompatable COL version. This 
may also be the result of using MDR to read a file which 
was not produced by COL, or was corrupted. 


User Action: Rerun MDR using a valid logfile. 


MDR -- INVALID MPB FOUND BY INF 
Explanation: The MPB did not pass validity testing when 
it was reread once the logfile buffer size was known. 
The logfile may have been corrupted while MDR_= was 
processing it. 


User Action: * * * SPR ! 


MDR -- INVALID POOL METRIC RECORDED 


Explanation: A Pool metric indicates more than 100% DSR 
usage. The metric is not reported. 


User Action: Ensure logfile is not corrupted. Do not 
change DSR size while COL is running. 

MDR -- INVALID RAD50 CHARACTER IN YOUR INPUT. PLEASE RETYPE. 
Explanation: The response to the taskname prompt for 
filtered names was not a valid RSX-11M taskname. All 


letters should be in uppercase. 


User Action: Correct and retype the response. 


MDR -- INVALID TIME VALUES; /AF MUST BE EARLIER THAN /BF 
Explanation: An attempt to use time filter values which 


overlapped causes this message. This condition will not 
allow any records to pass the filter for processing. 


User Action: Correct and reenter the MDR command. 
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-- MEMORY USAGE > 100% 


Explanation: MDR processed a system metric record which 
indicates greater than 100 percent of partition utili- 
zation. No graphic output will be produced for the 
suspect record. 


User Action: * * * SPR ! 


MISSING INFO FOR DEVICE METRIC 

Explanation: The Info record describing the system 
metric device was not found. Device system metrics will 
not be reported. 

User Action: Do not load or unload device drivers while 
COL is active. Ensure logfile is not corrupted. 


MISSING I$SYS FOR POOL METRIC 


Explanation: The DSR size was not found in the logfile. 
The Pool system metric is suppressed. 


User Action: Ensure logfile is not corrupted. 


MISSING "=" AND INPUT FILESPEC 

Explanation: The input command contains no "=" and no 
input filespec. Both input and output filespecs must be 
supplied or defaulted. 

User Action: Enter a corrected MDR command including 
the ee 

MORE THAN ONE INPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
input filespec. 


User Action: Enter a corrected MDR command with only 
One input filespec. 


MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 


Explanation: The MDR command contains more than one 
Output filespec. 
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MDR -- 
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User Action: Enter a corrected MDR command with only 
One output filespec. 


MPB FOUND AT LOCATION OTHER THAN FIRST RECORD OF FILE 

Explanation: An MPB was read in the wrong position in 
the logfile. This is indicative of a corrupted logfile. 
MDR will bypass this MPB and attempt to continue to 


process the corrupted logfile. Reports produced from 
this logfile are suspect. 


User Action: Use a different logfile for analysis. 


MPB NOT FOUND - NOT TRACE FILE 

Explanation: The MDR input file did not begin with a 
MPB. Either the file was corrupted or it is not a 
logfile. 


User Action: Use a different logfile for analysis. 


NO FOLLOWING PRIMARY RWB FOUND 


Explanation: An internal inconsistency was detected in 
pass I. 


User Action: * * * SPR ! 


NO FPP OR BUILT /-FP 

Explanation: MDR is unable to initialize for FPP ASTs. 
Either MDR was taskbuilt with the /-FP switch, or the 
processor where MDR is running has no FPP. This message 
cannot occur if the EIS version of MDR is used. 

User Action: Rebuild MDR using the distributed .CMD 


£5: Le Only run the FPP version of MDR on processors 
with an FP-ll. . 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the output 
filespec or an invalid output switch was specified. 


User Action: Correct and reenter the MDR command. 
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OVERFLOW BEFORE MPB - BAD TRACE FILE 


Explanation: The logfile indicates buffer overflow 
occurred before the MPB was written. Either the logfile 
Was corrupted, or the file was not produced by COL. 


User Action: Use another file for MDR input. 


OVERFLOW IN FIRST PASS SUMMARIZATION 


Explanation: A floating overflow occurred in pass I. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 


User Action: Use the resulting report with caution. 
Use filtering to limit the amount of data processed to 
prevent this condition. 

OVERFLOW IN SECOND PASS SUMMARIZATION 

Explanation: A floating overflow occurred in pass TT. 
Incorrect data will be reported for the particular task 
and summaries which this data represents. 

User Action: Use the resulting report with caution. 
Use filtering to limit the amount of data processed to 
prevent this condition. 

PARTITION RIB NOT FOUND FOR S$MEM 

Explanation: A system metric record was read for a 
partition which was not described by the system con- 
figuration information records. The graphic output of 
memory utilization will be suppressed. 


User Action: None. 


PRINT LINE TOO LONG 


Explanation: MDR generated a report file record longer 
than 132 bytes. The line is truncated by the logic 
which writes to the file. 


User Action: * * * SPR ! 
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MDR -- RIB LIST LINKAGE ERROR 


Explanation: An inconsistency was detected in MDR's 
jnternal representation of the system configuration. 


User Action: * * * SPR ! 


MDR -- RWB WITHOUT TWB FOUND IN RESOURCE. TMP 
Explanation: A record in the RESOURCE.SRT file was 
encountered in an illogical position. The record is 
disgarded. 


User Actions FF Oe SPR. | 


MDR -- SUMMARIZING FROM NULL TWB 


Explanation: An inconsistency was detected in the pass 
LT data structures. 


User Action: * * * SPR ! 


MDR -- SUMMARIZING INTO NULL TWB 


Explanation: An inconsistency was detected in the pass 
Li date structures . 


User Action: * * * SPR ! 


MDR -- SVTK FAILURE 


Explanation: The RSX executive rejected MDR's attempt 
to specrty an SST. vector. 


User Action: Correct the condition indicated by the DSW 
and rerun MDR. 


MDR -- SYSTEM + IDLE TIME > 100% 


Explanation: A system metric record was read which 
indicates the total of kernel and idle time is greater 
than the elapsed time. The graphic output for the 
record is suppressed. 


VALLES 


User Action: See Chapter 7, Section 7.5. 
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MDR -- SYSTEM TIME > 100% 


Explanation: A system metric record was read which 
indicates more kernel time than elapsed time. The 
graphic output for the record is suppressed. 


User Action: See Chapter 7, Section 7.5. 


MDR -- TI: READ ERROR 


Explanation: An I/0 error occurred when reading filter 
values from the user. 


User Action: Rerun MDR. 


MDR -- TRAP ### 


Explanation: A floating point or conversion error 
occurred. The octal number in this message indicates 
the precise error cause. 


User Action: * * * SPR ! 


MDR -- TRUNCATED INPUT FILE RECORD 


Explanation: The end of a buffer was reached before all] 
the records in that buffer were processed. This 
indicates a corrupted logfile. 


User Action: Use a different logfile for analysis. 


MDR -- TWB/RWB/RIB DYNAMIC SPACE ALLOCATION FAILURE 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass I. However sufficent 
dynamic storage was obtained to begin pass I. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 


requirement. Use of filtering of 


Ten 


MDR input will also 


lower this space requirement. Use overlaid MDR. 


iy gon GUIDE TO USING SPM-11M | 3-39 


MDR -- 


MDR -- 


MDR -- 


MDR -- 


7/81 


UNABLE TO ALLOCATE RESOURCE.SRT BUFFER 


Explanation: MDR was unable to get needed virtual space 
for a dynamic structure in pass II. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of filtering of MDR input will lower this space 
requirement. Use overlaid MDR. 


UNABLE TO ALLOCATE RIB 
Explanation: MDR was unable to sufficiently extend 
itself to provide space for initialization of pass Il. 


This indicates a severe shortage of necessary dynamic 
Space. 


User Action: Ensure MDR is checkpointable. Ensure the 
partition where MDR runs has enough space for MDR to 
extend. Use SET /MAXEXT to allow sufficient extension. 
Use of smaller buffers by COL will lower the MDR space 
requirement. 

UNABLE TO OPEN INPUT FILE 


Explanation: An [1/0 error occurred when MDR attempted 
to open the logfile. 


User Action: Correct the condition and rerun MDR. 


UNABLE TO OPEN OUTPUT FILE 


Explanation: An 1/0 error occurred when MDR attempted 
to open the report file. 


User Action: Correct the condition indicated by F.ERR 
and rerun MDR. 


UNKNOWN INFO TYPE RECORD FOUND 


Explanation: A. corrupted. togtilé,. or a file not 
produced by COL is being used as MDR input 
User Action: Use a different file for MDR input. 
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UNKNOWN RECORD TYPE 


Explanation: Corrupted  Logtiie, or << Ofi be not 
produced by COL is being used as MDR input. 


User Action: Use a different file for MDR input. 


VALIDATION ERROR 


Explanation: MDR is being used to process a logfile 
after the service period has expired. 


User Action: Contact your local Digital office to 
extend the service period. 

WILDCARD NOT ALLOWED IN FILESPEC 

Explanation: The MDR command contains a wildcard. 


User Action: Reenter the command without any wildcards. 


WRONG FOLLOWING PRIMARY RWB FOUND 


Explanation: An inconsistency was detected in MDR's 
pass I dynamic data. 


User Action: * * * SPR ! 


Using CLF 


used to copy logfiles produced by COL. The three modes 
Operation are: 


Buffer Transfer Mode, 

which copies a logfile from either disk or tape, to 
disk or tape, maintaining the logfile format which MDR 
uses for input. 

FCS Record Transfer Mode, 

which copies a logfile from either disk or tape, 


producing an output file with variable length FCS 
records. 
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e@ Read-only Mode, 


which reads the logfile, computes overflow and buffer 
counts, but does not create a new file. 


The general procedure for using CLF is: 


>RUN CLF 

CLF> [OUTFILE/sw =] LOGFILE/sw 
Note that the output filespec and "=" are optional. If these 
are not specified, CLF will operate in read-only mode, 
producing no output file. 


When FCS mode is specified (by the /FCS switch), the records 
have the format specified in appendices A through D. The first 
word of each record is the record ID which uniquely identifies 
the record type. If overflows occur within the data stream, a 
special “overflow record" is placed in the output file at the 
point where records were lost due to overflow. The format of 
this (length = 4. bytes) record is: 


500 0 600(8) = overflow record ID 


#H# 2 count of records lost by overflow at 
this point 


When the /FCS switch is used, the default output filespec is 
changed to TRACE.FCS. 


After CLF has completed reading the input file, the run 
statistics will be reported to CLF's TI:. 
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CLF Switches 
Switch defaults -- 
output: SY:TRACE.LOG/-AP/DE:800/-FCS 
input: SY:TRACE.LOG/DE:800/RW/SK:0 


Output Switches Description 


/AP /-AP APpend file to the end of magtape. CLF 
will space over all existing files on the 
magtape and write the new file starting at 
the current end-of-volume point. 


/DE:nnnn Selects output magtape DEnsity, 800 or 1600 


/-FCS Selects FCS formatted output file 


/FCS 


Input Switches 


/DE:nnnn Selects input magtape DEnsity, 800 or 1600 
(ignored unless /RW is also used) 

/RW /-RW ReWind tape input file before opening 

/SK:nnn SKip nnn files when opening tape input file 


eee a ree, 


CLE Messages 


The CLF messages are issued to the TI device under which CLF is 
run. This section discusses the messages which CLF can issue. 


CLF -- #### BUFFERS READ 

CLF -- #### RECORDS READ 

CLF -- #### BUFFERS WITH OVERFLOW 
CLF -- #### RECORDS LOST BY OVERFLOW 


Explanation: This statistics message is output at the 
completion of each run of CLF, indicating the statistics 
about the input file. 


User Action: None. 
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CLF -- 


CLF -- 


CLF -- 
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DSW:it#d#t# F.ERRi: ###### LOSB: ###### 8 FHHHHH PC #HAHHE 
SPi ttt dt # 

STK: ###### #t# HHH 

Explanation: This is a status message which gives 
detail of the internal state of CLF at the time when an 
error is detected. This message is always followed by 
one of the messages discussed below, which describes the 
actual error condition. 

User Action: See action specified for the message 
issued immediately after this status message. 

COMMAND READ ERROR 


Explanation: An I/0 error occurred while reading the 
command line. 


User Action: Reenter the command. 


COMMAND SYNTAX ERROR 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


COMPLETION ERROR IN INPUT READ 

Explanation: an I/0 error occurred while reading the 
input file. This condition, which may be symptomatic of 
a corrupted logfile, will be treated as end-of-file. 
User Action: Check Fs.ERR and. 1OSB for error cause, or 
use another logfile. 


ERROR ASSIGNING INPUT DEVICE 


Explanation: CLF was unable to assign a LUN to tht 
input file. 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 


ERROR ASSIGNING OUTPUT DEVICE 


Explanation: CLF was unable to assign a LUN to the 


output file. 
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CLP ss 


CLF -- 


Clete 


P/S1 


User Action: Check DSW and F.ERR for cause. Ensure the 
filespec syntax is correct. 


ERROR ATTACHING, POSITIONING OR SELECTING DENSITY OF 
MAGTAPE 


Explanation: An I/0 error occurred when attempting to 
open a file on magtape. 


User Action: Ensure the drive is not mounted if logfile 
format is used for that file. Ensure the output drive 


is selectable, and not write locked. Correct the error 
indicated by DSW or IOSB. 


ERROR CLOSING INPUT FILE 


Explanation; An I/0 error occurred when closing the 
input file. 


User Action: None. 


ERROR CLOSING OUTPUT FILE 


Explanation: An 1/0 error occurred when truncating or 
closing the output file. 


User Action: Correct the condition and rerun CLF, or 
manually unlock the output file. 

ERROR IN INPUT READ QI0 

Explanation: An 1/0 error occurred while reading the 
input file. This condition, which may be symptomatic of 


a corrupted logfile, will be treated as end-of-file. 


User Action: Check DSW for cause. Rerun using another 
logfile if necessary. 


o 


ERROR READING MPB 


Explanation: An 1/0 error occurred when reading the 
first block of the logfile. 


User Action: Correct the condition and rerun. 


GUIDE TO USING SPM-11M 3-45 


CLE 


ele 


CLF 


CLE 


CLF 


GLE 


7/81 


ERROR WRITING TO OUTPUT FILE 


Explanation: An I/0 error occurred when writing to the 
output file. 


User Action: Correct the condition and rerun. 


INPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
filespec. 


User Action: Reenter the corrected command. 


INVALID DENSITY SELECTED, 800 OR 1600 ONLY 


Explanation: A magtape density other than 800 or 1600 
was specified. 


User Action: Reenter the command with a correct 
density. 

INVALID INPUT DEVICE TYPE 

Explanation: An attempt was made to read a file not on 
disk or tape. Disk and tape are the only acceptable 
media for logfiles. 

User Action: Do not-use CLF to read files not on disk 
or tape. 

INVALID MPB FOUND 

Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 


logfile. This may be caused by a corrupted or obsolete 
logfile. 


o 


User Action: Use a different logfile. 


INVALID OUTPUT DEVICE TYPE 


Explanation: An attempt was made to write in logfile 
format to a device other than disk or tape. 


User Action: Only write logfile format to disk or tape. 
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MORE THAN ONE INPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MORE THAN ONE OUTPUT FILESPEC NOT ALLOWED 
Explanation: The command has improper syntax. 


User Action: Reenter the corrected command. 


MPB NOT FOUND - NOT TRACE FILE 
Explanation: The first block of the input file does not 


pass certain validity tests which ensure the file is a 
logfile. This may be caused by a corrupted or obsolete 


logfile. 


User Action: Use a different logfile. 


OUTPUT FILESPEC OR SWITCH SYNTAX ERROR 


Explanation: A syntax error was detected in the input 
filespec. 


User Action: Reenter the corrected command. 


OVERFLOW BEFORE MPB - BAD TRACE FILE 
Explanation: The first block of the input file does not 
pass certain validity tests which ensure the file is a 


logfile. This may be caused by a corrupted or obsolete 
logfile. 


User Action: Use a different logfile. 


TRUNCATED INPUT FILE RECORD 

Explanation: The end of a buffer was reached before all 
records in that buffer were processed. This indicates a 
corrupted logfile. 


User Action: Use a different logfile. 
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CLF -- UNABLE TO OPEN INPUT FILE 


Explanation: An 1/0 error occurred while opening the 
TOU oF Pes 


User Action: Correct the condition and rerun. 


CLF -- UNABLE TO OPEN OUTPUT FILE 


Explanation: An 1/0 error occurred while opening the 
output file. 


User Action: Correct the condition and rerun. 


CLF -- UNKNOWN RECORD TYPE 


Explanation: An unknown record ID was found in the 
file. 


User Action: Use a different logfile. 


CLF -- WILDCARD NOT ALLOWED IN FILESPEC 
Explanation: A wildcard was found in the command. 


User Action: Reenter the command without wildcards. 


ee are) Writing User Information to the Logfile 


The QPDRV driver provides a way for a user task to write user 
information to the same logfile that COL currently has open. A 
task does this by issuing a QIO to QP:, with up to six words 
of user information specified in the QIO parameter words. 


The QPDRV driver is similar to the null driver NLDRV. It is an 
infinite sink for writes and an infinite source of EOFs fore 
reads. QPDRV is compatible with FCS and RMS QIO functions. 
All of the following QIO functions are defined as legal and 
Control For. -QPDRVs /TOcKLE, DOsRER,. PO.Woes TO<ATT, 1O.DETY 
IO.FNA, IO.ACR, I0.ACW, IO0.ACE, I10.DAC, IO.RVB and I0.WVB. 


QPDRV contains a hook point defined as H$USER. When a QIO jis 
issued to QP:, a hook record with hook ID H$USER is written. 
The H$USER record contains the six QIO parameter words speci- 
fied by the user. Sec Appendix A for a complete specification 
of the hook record. 


7/81 GUIDE TO USING SPM-11M 3-48 


To use QPDRV, you must load it by the command: 
>LOA QP: 


QPDRV is built via the command file PMONBLD.CMD. The image and 
Symbol table files for QPDRV are contained in £1,54]. 


Example: 


ALUN$C 1,QP,0 
QIOW$C IO.WLB,1,1,,,, <100,200,300,400,500,600> 


will result in a H$USER record with the QIO parameters 100, 
200, 300, 400, 500 and 600 written to the logfile. 


To dump a stream of H$USER records in the performance report, 
you run MDR and use the /DM:40 switch. If you only want the 
H$USER records printed, the suggested command syntax is: 


MDR> output=input/DM:40/L1:0/S1:0 


Usage note: If you enable device type "OTHER" in SMPGEN, then 
for each QIO to QP:, three hook records are written: HSQDRV, 
H$IODN and H$USER. However, if you disable device type “OTHER" 
in SMPGEN, then for each QIO to QP: only the H$USER hook record 
is written. 
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Chapter 4 
DATA COLLECTION AND 
REDUCTION PROCEDURES 


COL and MDR are complementary tools which can be used to 
collect large amounts of performance data and interpret the 
data to a great degree of precision. Both COL and MDR have a 
number of parameters and switches which provide flexibility in 
both collecting and interpreting the data. In the following 
sections we describe how to utilize the parameters of COL and 
MDR to collect the best possible set of data to analyze your 
computer system. 


4.1 DATA COLLECTION PROCEDURE 


There are a number of questions you should answer before 
running COL to collect data: 


® Length and type of ineacumemene interval? 

® Resource types enabled for data collection? 
® Device classes enabled for data collection? 
@ Tasks enabled for data collection? 


@ System metrics enabled? 


A Ael Measurement Period 


The measurement period is defined as the time during which COL 
is collecting data. Typically this time is one continuous time 
interval; however, it may consist of a number of time intervals 
piecewise added together. 
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Under most conditions, you should select a continuous measure- 
ment period. This is done by running COL either in MANUAL mode 
or AUTOSTOP mode. 


MANUAL mode should be used when: 
@ There is an operator available to terminate COL. 


@ You estimate the logfile space available is sufficient 
to contain all the data collected for the measurement 
period. 


AUTOSTOP mode should be used when: 
® An operator is not available to terminate COL. 


@ You want to run COL for a fixed amount of time 
(AUTOSTOP on TIME). 


® You want to set a limit on the amount of logfile space 
used (AUTOSTOP on BUFFER). 


Under some conditions, particularly if the system is under 
heavy activity for long periods of time, COL will collect too 
much data given the available logfile space. To reduce the 
logfile space used, you can run COL in REPEAT mode. However, 
you should do so carefully. The chief concern when running COL 
in REPEAT mode is that “incomplete intervals" may result if a 
task or operation is outstanding exactly when COL starts or 
stops data collection. For example, if you start COL precisely 
when a task is active and has an I/0 operation queued to the 
disk, an incomplete interval will be flagged by MDR for both 
the task invocation and for the I/0 operation. This condition 
does not invalidate other information in the performance 
report, it just “leaves out" some information which potentially 
may be valuable. You can minimize the number of incomplete 
intervals by minimizing the number of times COL enables or 
disables data collection for a measurement period. 


Let's say you want to collect data during a normal 8-hour 
daytime shift and you have only one 2400 foot magtape available 
for the logfile. However, you estimate that if COL runs all 
day, about two 2400 foot tapes will be needed. What you need 
to do is cut the amount of data collected in half. Consider 
the following alternative measurement schemes: 


@ 
me Oo 
fey] 
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® Sample time = 30 minutes; Time between samples = 
30 minutes. 


® Sample time = 2 hours; Time between samples = 
2 hours. 


Scheme 1 will usually result in the highest number of 
incompletes, yet it probably will not "miss" any important 
System activity. Scheme 3 will probably result in the lowest 
number of incompletes, yet it is vulnerable to missing 
important intervals of system activity. Scheme 2 will probably 
result in a low number of incompletes, yet it has a good chance 
of capturing all periods of important system activity. 


What we're observing here is an old problem in communications 
systems: How fast do you sample a signal to be able to 
reconstruct the signal from the sampled data? In our case, the 
problem is: how fast do you sample the workload in order to 
reconstruct it? 


In communication systems, you sample the signal at twice the 
highest frequency in the signal. In computer systems, it would 
be reasonable to sample the workload at twice the highest 
frequency of variation in the workload. Thus if you observe 
the workload to fluctuate up and down about four times per day, 
then 8 samples per day (every 30 minutes) would reduce the 
amount of data and yet collect sufficient data to reconstruct 
the workload. 


4.1.2 Resource Types 


Normally you want to collect data for all resource types (CPU, 
memory, I/0). If the amount of data collected is too large, 
you can select one resource type per measurement period and run 
a number of measurement periods. 


The hooks are grouped according to resource type. To select a 
particular resource type, you select the corresponding hook 
group. to 


Ae 3 Device Classes 


The device classes are: Directory, Sequential, Terminal, and 
Other. If you want to measure the resource contention for a 
device, select it for data collection. Normally the disks are 
shared devices and should be selected. If the line printer 18s 
spooled and attached to the despooler task you may not need to 
collect usage data for it. Similarly, terminals are normally 
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singly used by one task at a time; the measurement results may 
not be useful from a resource contention point of view. 


4.1.4 Tasks 


The tasks selected for data collection are the definition of 
the workload that you want to measure. For example, if you 
want to analyze the application workload, select all the tasks 
in that workload and deselect the system service tasks such as 
FIIACP, MCR..., and QMG.... On the other hand, if you want to 
measure the system resources that a particular FI1iACP is 
consuming, enable only F11ACP and disable all other tasks. 


Le re) System Metrics 


Normally system metrics should be enabled with a sample 
interval of 60 seconds. If you want to save logfile space and 


report paper, longer sample intervals may be used. 


4.2 DATA REDUCTION PROCEDURE 


Once you have a logfile on disk or tape, you are ready to read 
the logfile with MDR and reduce the data to a usable perfor- 
mance report. A guide to reading the performance report is 
given in Chapter 5. 


The data reduction procedure should consist of a number of 
steps methodically performed. A general guideline is to first 
obtain a number of overviews of the system activity during the 
entire measurement period and then print detailed analyses of 
the subset measurement intervals of interest. For example, if 
during an 8 hour shift there were two intervals of peak 
activity, from 9 to 11 a.m. and from 2 to 4 p.m., you should 
first run MDR with /LI:0 to get a system metrics scan of the 
entire 8 hour shift, and then run MDR with /AF and /BF to get a 
report of only the peak morning activity and again with /AF and 
/BF to get only the peak afternoon activity. The general 
procedure is as follows: 


@ Run MDR with /LI:0 for entire logfile. 
Identify the intervals of interest and record their 
endpoints of time using the KW11-P clock timestamps 
printed above the system metrics. 


® Rerun MDR once for each subset measurement interval 
using /AF and /BF with the /LI:2 switch. 
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This will give both system and task summaries. 
Identify the largest consumers of resources and record 
their tasknames. 


Rerun MDR with /LI:4 or /LI:5 and /TS for the tasks 
desired. 


Observe a detailed analysis of the particular tasks 


which consumed the resources and the times when these 
resources were consumed. 
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Chapter 5 
READING THE 
PERFORMANCE REPORT 


SL PERFORMANCE REPORT DATA 


When reading this section, refer to Appendix F, which contains 
a sample performance report. 


The performance report consists of four sections: 
® Measurement Parameters 
® System Configuration 
® System Metrics 


® Task Metrics 


Saba Measurement Parameters 
The measurement parameters are read from the Monitor Parameter 
Block (MPB) which is the first block of the logfile. The MDR 
task extracts the information from it and prints the measure- 
ment parameters on the first page of the performance report. 
The items printed are: 

@ Label. . 

® Measurement mode. 

® Buffer type, partition, number and size. 

® Resources selected for System Metrics. 


@ TI filter device (if selected). 


@ Tasks selected for data collection. 
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8 Devices selected for data collection. 
® Hooks enabled. 


@ MDR command line 


se eee System Configuration 


The system configuration information is contained in 
Information Records and directly follows the MPB in 
logtile. If the /SC switch is specified, the MDR task w 
extract the information from these records and print it to 
logfile. The information printed is: 


the 
the 
il] 
the 


@ The Pool (DSR) size in bytes and the executive feature 
mask. 


e A list of the partitions in the system when COL was 
activated. 


e A list of the controllers and units in the system when 
COL was activated. 


@ A list of the tasks installed in the system when COL 
was activated. 


® A list of the active checkpoint files and their sizes 
when COL was activated. 


od rec System Metrics 


The system metrics are system-wide measurements of CPU usage, 
pool usage, the usage of a selected partition, checkpoint file 
usage, and the usage of a selected device. Measurements are 
made for cach sampling interval and the results written to the 
logfile. The length of the sampling interval is selected in 
the SMPGEN.CMD procedure. The system metrics are: 


® CPU Usage re 
For each sampling interval, counters are kept for the 
total times spent in kernel and idle states. The 
remainder of the sampling interval time is assumed to 
be user state. To depict CPU usage, a histogram is 
printed on the performance report. Each 1% of time 
spent by the CPU in user mode is represented by a 
single Jetter "U". Each 1% -0f time spent by the CPU 
in kernel mode is represented by a single letter "K". 
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The user time is left justified and grows from left to 
right; the kernel time is right justified and grows 
from right to left. If any blank spaces exist in the 
line, they represent CPU idle time. 


Pool Usage 


At the end of each sampling interval, COL scans the 
RSX-11M system pool and measures the percentage of 
BOO] Tn use. The percentage of pool used is 
represented by a histogram, where each "P" represents 
1% of pool usage. 


Partition Usage 


The user selects a partition to be monitored via the 
COL switch /PR:parnam. At the end of each sampling 
interval, COL scans the partition data structures for 
the selected partition to measure the percentage of 
the memory in use in the partition. The percentage of 
memory used in the partition is represented by a 
histogram, where each "M" represents 1% of partition 
usage. 


Checkpoint File Usage 


When COL is activated, it scans the checkpomnt: file 
list and records a list of all active checkpoint files 


and their sizes. 


At the end of each sampling interval, COL scans the 
checkpoint file list and measures the percentage of 
all active checkpoint file space in use. If there is 
more than one checkpoint file, COL sums the space in 
all checkpoint files to compute the percentage. The 
percentage of checkpoint file space used is repre- 
sented by a histogram, where each "C" represents 1% of 
checkpoint file space usage. 


Device Usage 


The user selects a device to be monitored via the COL 
Switch /DV:ddnn. For each sampling interval, COL 
tallies all the I/0 request times for the selected 
device to get the percentage of time that the I/0 
device was in use during the sampling interval. The 
percentage of time the device was used is represented 
by a histogram, where each "Dp" represents 1% of device 
usage time for the sampling interval. 
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In addition, if the device is a Files-11 disk and is 
mounted native, the number of disk blocks used on the 
volume is computed at the end of the sampling 
interval. The percentage of disk space used is 
represented by a histogram where each "B" represents 
1% of the total volume space used. 


For each sampling interval, the histograms for CPU, pool, 
memory, checkpoint file space, and device are clustered 
together into six successive lines on the report. 


The end of each sampling interval is timestamped and printed in 
two formats: KW11-P time and RSX-11M system time. 


The KW11-P time is printed as two octal numbers: the: Pett 
number is the high order part and the right number is the low 
Order part. The corresponding RSX-11M system time is printed 
a5 HRS MING SEG. TENTHS. 


The KW11-P timestamp can be used to: 


@ Correlate an individual task report page (which has 
the same form of timestamp) with a particular system 
metric line. 


n val of interest 


® Select a particular measurement ter 
/BF switches. 


; 
by rerunning MDR using the /AF and 


The totals for CPU kernel time, CPU idle time and device busy 
time are given for each measurement interval. 


The last item in the system metrics section is the “Total Data 
Reduction Period". This is the total time for which data was 
reduced. If the report was generated using the /AF and /BF 
Switches, only the data reduced between /AF and /BF is counted. 


beled Task Metrics 
Levels of Task Summarization 


The task metrics describe the usage of the resources in the 
system on a task-by-task basis. There are a number of levels 
of summarization available in the performance report, which 
enables the user to choose between a very detailed report or a 
shorter summarized report. The levels of summarization and 
their corresponding switches are as follows: 
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Individual’ Task: Invocations (/L174 or /L125) 


An individual task invocation is defined as a single 
run of a task, that is, the time between an executive 
Run Task event and an executive Exit Task event (the 
exact placement of the hooks for these events is 
specified in Appendix A). A complete set of task 
metrics will be printed for each task invocation. If 
most or all tasks in the system are enabled for data 
collection, a report containing individual task 
invocations may be quite long. 


Task by Ti. Summary €/LI:3) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) and the same TI are grouped together when the 
statistics are computed. The task metrics then reveal 
the measurements summed across all tasks with the same 
generic taskname from the same Tl. 


Task Summary (/LI:2) 


In this level of summary, the task metrics for tasks 
with the same generic taskname (see Chapter 2, section 
2.2.2) are grouped together when the statistics are 
computed. The task metrics then reveal the measure- 
ments summed across all tasks with the same generic 
taskname. 


System-Wide Summary (/LI:1) 


In this level of summary, the task metrics for a 
tasks in the system that were enabled for da 
collection are grouped together when the statisti 
are computed. The task metrics then reveal t 
measurements summed across all tasks in the system. 


1] 
ta 
cs 
he 


Task Metric Data 


The following data is presented in the performance report for 


al] 
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levels of task summarization. 


Generic TASK 
The generic taskname (see Chapter 2, Section 2.2.2 


ys 
printed on the top of the page to identify the task 
for which the data applies. 
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Elapsed Times 


The elapsed time is the time from a Run Task event to 
an Exit Task event. 


Number of Task Invocations 


The Number of Task Invocations is the number of times 
that a Run Task event occurred for the task. If the 
COL task is started while a task is in progress, the 
Run Task event will not be recorded in the logfile for 
that task. When the task exits, an Exit Task event 
will be recorded to the logfile. When MDR reads an 
Exit Task event without a corresponding Run Task 
event, it reports an “incomplete" invocation in the 
Number of Task Invocations line. 


Memory Times 
There are three memory times: 
- In (memory) 


- Out (memory) - includes time waiting for memory on 
initial task load and all time checkpointed 


(waiting and stopped). 


- Wait (memory) - includes time waiting for memory on 
initial task load and time checkpointed (waiting 
only). 


Memory Size in K Words 
Size of the task region. 
Space-Time Product 


The space-time product is the amount of memory that a 
task uses integrated over the time that the memory was 
used. Each increment of memory used (in K words) is 
multiplied by the time (in SECs) that the increment 
was used, and all products are summed to get the 
Space-time product. If a task changes its size via an 
Extend Task directive, the corresponding change in 
memory usage is computed. 
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ACP Counts 


The ACP Counts are tallied across all ACPs the 


in 
System. They are not broken down by separate ACP. 


There are seven categories of ACP functions printed on 
the performance report. They are: 


- Access/Deaccess 
These functions are: Access File for Read, Access 
File for Read/Write, Access File for Read/Write/ 
Extend, Deaccess File, Connect Logical Link, and 
Disconnect Logical Link, and Close Out LUN. 

- Create/Delete 


These functions are: Create File, Delete File and 
Truncate File. 


- Read/Write 
These functions are: Read Virtual Block, Write 
Virtual Block, Receive Message and Transmit 
Message. 

- Directory 
These functions are: Find File Name in Directory, 
Enter File Name in Directory and Remove File Name 
from Directory. 


- File Attribute 


These functions are: Read File Attributes and Write 
File Attributes. 


- Extend 
This is the Extend File function. 

- Other 
These functions are all ACP functions other than 
those listed above, such as: Unlock Block, User 


Magtape Control Function and Network Control 
Functions 
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Memory Residency 


The Memory Residency count is incremented each time a 
task successfully allocates memory for an initial task 


load or for a checkpoint read. 


CPU Timeslices 


A CPU Timeslice is the time between a Load Task 
Context event and a Save Task Context event, minus the 
idle time accrued during that period. Note that if a 
task issues a directive and the processor switches to 
kernel mode, the corresponding time in kernel mode is 
charged to the active task's CPU timeslice. Also, if 
an interrupt occurs while a task's context is active, 
the corresponding kernel mode time is charged to the 
active task's CPU timeslice. 


Initial Loads 


Initial Loads is the number of Initial Task Load 
events for the task. The USAGE times indicate the 
time it took the loader task to load the task; the 
WAIT times indicate how long a task's load request was 
in the loader task's queue. 


Checkpoint R+W 


Checkpoint R+W is the number of Checkpoint Read and 
Checkpoint Write events for the task. The USAGE times 
indicate the time it took the loader task to check- 
point (read or write) the task. (Note: the USAGE 
times do not indicate how long a task was check- 
pointed. This information appears under "Memory 
Times" on the task metric page.) 


DDnn Ovly Loads 


DDnn Ovly Loads is the number of overlay read (I0.LOV) 
QIOS the task issued to device DDnn. 


DDnn QIOs 


DDnn QIO0s is the number of logical QI0s a task issued 
to device DDnn. Please note the following caveats: 


- DDnn Ovily Loads is included in this count, since 
LOvLOV sa -Legiea! Bleck O10. 
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- Task IO.RVB and IO.WVB (virtual) QIOs which are 
successfully and entirely mapped by the executive 
or FIIACP to IO.RLB and I0.WLB (Logical) QIOs are 
included in this count. 


- Task IO.RVB and IO.WVB (virtual) QIOsS which a 
sent to FLIACP, and which are performed by FIIA 
on behalf of the task (partially mapped, multip 
transfers), are not included in this count. Thi 
logical block I/0 is charged to FIIACP. 


- The 10.ATT, I0.DET and I0.KIL QIOs are not included 
in this count. 


USAGE Times 


The USAGE times indicate how long a task used a resource. 


WAIT Times 


The WAIT times indicate how long a task was waiting for the use 
of a resource. 


SERVICE Times 


The SERVICE time is the USAGE time plus WAIT time which 
occurred for each resource request. Note that the minimum 
SERVICE time is not necessarily equal to the minimum USAGE time 
plus minimum WAIT time, since the minimum USAGE time may have 
occurred for a different resource request than the resource 
request which had the minimum WAIT time. The same applies to 
the maximum. 


ARRIVALS PER SECOND 


The mean task rate is the number of resource requests issued by 
a task divided by the task's elapsed time. Ee, eld Se. SOOM ad 
task's point of view, the rate of resource requests issued by 
a task. The mean system rate is the number of resource 
requests issued by a task divided by the data reduction period. 
It tells, from a resource's point of view, the rate of resource 
requests issued by a task. 
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Resource Metrics 


For each resource used by a task, the following metrics are 
printed on the report: 


® Count 
The number of times a task used a resource. 
® Total Time 


The total time during which a task used the resource 
(equal to the sum of all resource usage intervals). 


@ % Resident Time 
% Resident Time is (Total Time/Resident Time) * 100%. 
@ Minimum 


The smallest interval during which a task used a 
resource. 


® Mean 


The arithmetic average of all resource usage intervals 
for a task. 


C) Maximum 


The largest interval during which a task used a 
resource. 


@ Coefficient of Variation 


The coefficient of variation is the standard deviation 
of the intervals divided by the mean interval. 


® % Resource 
% resource is the total time a task used the resource _ 
divided by the total time of the Data Reduction Period 
(total resource time available). 

) Incomplete 
If the logfile does not contain a "complete" set of 
events needed to define an interval, MDR will tally 


the interval as an “incomplete”. For example, if MDR 
reads a 1/0 Done event from the logfile for a certain 
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task and device and there is no corresponding Get I/0 
Packet event for the task and device, MDR will regard 
the I/0 interval as an incomplete. Incomplete 
intervals can occur if COL starts data collection 
while an operation (interval) is already in progress. 


The only data recorded for incomplete intervals is the 
count; no timing information is computed since the 
information is not precise. 


Incomplete intervals are printed in lieu of the % 
resource metric if the /IC switch is specified. 
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Chapter 6 
RESOURCES USED 
BY SPM-11M 


The purpose of this section is to give an estimate of the 
resources used by the COL and MDR tasks. 


651 RESOURCES USED BY COL 
@ CPU 


When a task metric hook is encountered, from 50 to 75 
instructions are executed at system level (PR=0, 
$STKDP=0) before returning to the main flow of the 
executive. 


@ System Pool 


When the COL task is inactive, about 115 words of 
executive space are used. This is accounted for by 
the hook points (3 words per hook), 4 words added to 
system common, 16 words added to the system stack and 
a dummy hook return routine added to SYSXT. 


When the COL task is activated, approximately 215 more 
words of system pool are used. 


@ Physical Memory 
The COL task occupies about 4K words of physical 


memory. The COL buffers (either in a static common or 
dynamic region) can vary from 0.5K words to 32K words. 
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1/0 Requests 


The COL task issues a FCS WRITE$ to write a buffer to 
disk; it issues a QIO$ to write a buffer to magtape. 
The rate of I/0 requests generated by COL depends on 
the system activity that COL is tracing. 


RESOURCES USED BY MDR 


Memory 


The code and static data of MDR requires varying 
amounts of memory depending upon which version is 
Did, See the TASK IMAGE SIZE in MDR.MAP. 
Additional space is required for I/0 buffers = and 
dynamic structures which are manipulated within MDR's 
virtual address space. MDR will automatically extend 
its virtual space as needed to accommodate these 
structures. Typically MDR will require an additional 
8KW for all the dynamic storage. 


Pool 


All MDR I/0 is singly buffered, and synchronous, 
minimizing the use of pool. 


1/0 
Each pass of MDR reads a single file and writes to the 
report file. During pass I the RESOURCE.TMP file is 
also being written. Terminal I/0 is used for command 
input, and error reporting. The DRS task will have up 
to 7 files concurrently opened for I/0. 
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Chapter 7 
USAGE NOTES 
SPM-11M 


Ped TASKBUILDING COL 


COL must be taskbuilt using the baseline library 
FL,1JSYSLIB.OLB (which does not contain FCS routines with ANSI 
or big buffering). 


rf COL “ts taskbutlt with the ANSI or big buffering FCS 
routines, its size may be greater than 4096 words. The result 
will be that when COL is run, it will not be able to create an 
address window (the error received will be COLMSG -- CANNOT 
CREATE BUFFER PARTITION OR ADDRESS WINDOW). 


ape COL BUFFERS 


When COL starts up it copies all the TCBs, PCBs, DCBs and UCBs 
to the logfile. There must be enough buffer space to store all 
of these data structures simultaneously, otherwise COL will 
print the error message COLMSG -- INFORMATION RECORD ALLOCATION 
FAILURE. 


Before COL is left to run unattended for long periods of time, 

COL should be run for 5 to 10 minutes under a typical heavy or 

peak system workload and the console terminal should be, 
monitored for the occurrence of overflow errors, i.e., COLMSG 

-~- BUFFER OVERFLOW. If buffer overflows occur, the buffer size 

for COL can be increased by using the /BF switch (see Chapter 

33; SGCEION: aeeees 5 


Another cause of COL overflows may be small disk file extent 
sizes. When COL attempts to write a buffer to the Togfile, 

P may have to do an extend file operation before the 
actual data write can be done. The time 1G takes. FLLACP Co 
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extend a file may be long, and COL may overflow as a result of 
this. To remedy this situation, two switches have been built 
mt: LOLs 


® Initial File Size /IF 
@ Extend File Size /EX 


If an estimate can be made of the maximum logfile size before 
COL is run, it is best to preallocate all the logfile space via 


the JTF swriens In this case COL will not need FI1ACP to do 
any extend file operations during its run and this may prevent 
overflows from occurring. 


hig STATE OF SYSTEM AT COL STARTUP TIME 


When COL starts up, it copies the TCBs, PCBs, DCBs and UCBs in 
RSX-11M to the logfile. The MDR task later refers to these 
data structures to derive the necessary context for printing a 
performance report. 


To assure that MDR will have all the context it needs to print 
the report, you should insure that the following conditions are 
satisfied before starting up COL: 


® All tasks installed 


If you want to disable a task for data collection, 
that task must be installed when COL starts up. All 
tasks dynamically installed after COL starts will 
always be enabled for data collection. This means 
that all multiple copies of a multiuser task will 
always be enabled for data collection. 


® All partitions set up 


If you want memory metrics kept for a partition, the 
partition must be set up 
(via SET /MAIN=XYZPAR:m:n:type) before starting COL. 


® All drivers loaded 
If you want the I/0 metrics kept for a device- unit, 
the driver managing that device-unit must be loaded 
before Starting COL. 

e All devices mounted 
If you want the correct ACP taskname for a mounted 
volume to be printed on the performance report, the 


volume must be mounted before Starting COL. Other- 
wise, MDR will print a "pseudo" taskname for the ACP. 
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Example: If the device DKl: is mounted to the FI11ACP 
task after data collection is in progress for COL, MDR 
will print the pseudo name DK1***ACP on the report. 

6 All checkpoint files allocated 
If you want the system metrics for checkpoint file 


usage, be sure to allocate all checkpoint files with 
the ACS command before starting COL. 


PA TASK BUILDING MDR 


MDR will run on processors with or without hardware FPP (float- 
ing point processor) support. If your processor does not have 
hardware FPP, it must minimally have hardware EIS instructions. 
You must taskbuild MDR to reflect the type of hardware (FPP or 
EIS) on your processor. You can build MDR either overlaid or 
non-overlaid with both FPP and EIS versions. To build MDR, 
invoke the build command file: 
>@MDRTKB 


This command file will prompt you to build any of the four 
available versions: 


1. FPP support, overlaid 
2. FPP support, non-overlaid 
3« ETS Support, over aid 
4. EIS support, non-overlaid 
You can change certain MDR defaults by editing the taskbuild 
command file produced by MDRTKB.CMD. The MDRTKB.CMD procedure 
will prompt you for changing the defaults. The defaults which 
can be changed are: 
e Number of lines per page in REDUCE.RPT file 
r) Default values for /LI switch 
6 Default values for /SI switch 


e Default magtape logfile density (/DE) 


@ Default value for /DM switch 
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ae USE WITH LAYERED PRODUCTS 


SMP-11M inserts hooks into the RSX-11M executive at standard 
places where the executive does allocations and deallocations 


of resources. 


SPM-11M measures kernel CPU time by hooking the standard 
interrupt save (PINTSY, SINTSE,. SINTSC) -and system exit 
($DIRXT) points. 


If any layered product or user privileged component uses 
nonstandard techniques for resource allocation or interrupt 
entry, the SPM-11M measurements will be inaccurate. 


For example, DECNET uses a nonstandard interrupt save routine, 
which means the kernel CPU time measurement will be inaccurate. 
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Appendix A 
HOOK RECORD 
DEFINITIONS 


NOTE: All record offsets in this appendix 
are expressed in octal bytes. 


All record lengths are expressed in 
decimal bytes. 


HOOK RECORD DEFINITIONS A-1 


1.0 


dy 


1.2 


tec% 


7/81, 


-l 


v2 


H$CDRP - CALL DIRECTIVE PROCESSOR 


LOCATION 
DRDSP.MAC 
After $SEMTRP: :DIRSV$ 
After $DPLM2: :MOV (SP)+,R3 
After 50$: MOV R5,R2 
Follow MOV $HEADR,R4 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB (Current Task TCB) 
$DICSV (Directive ID Code) 


Record Format - 


aaa 
Timestamp 2 
ail 
Taskname (RAD50) 6 
neon geet eet Ae: 
TI UCB Address 12 
pees EA eae Th ae ee 
DIC 14 
i esl 
Record Length - 
14. bytes. 
HOOK RECORD DEFINITIONS A-2 


2.0 H$RTSK - REQUEST TASK TO RUN 


Zea LOCATION 


REQSB.MAC 
After 
After 
Follow MOV 


SKRP:: 


re oO 
ro 


anes DATA COLLECTION 


Pore |b Storage Dependencies - 


RO=TCB address 


Cwewe Record Format - 


Hook I.D. 0 

Timestamp 2 

Taskname (RAD50) 6 
aa Lert 

TI UCB Address 12 
fehl es Se ea 

Request UIC 14 


PS a hn Bote iy ae See a tt ed 


Oe 2%.3 Record Size - 
14. bytes. 


R2,T-UCB(RO) 


fed HOOK RECORD DEFINITIONS 


a0 H$XTSK - TASK EXIT 


cee LOCATION 
DREIF.MAC 
AToer SCENES 


After 134$: 
Follow .ENDC sP$$0FF 


Sune DATA COLLECTION 


Seow Storage Dependencies - 


$TKTCB=TCB address 


Sale Record Format - 


0 

Timestamp 2 
Taskname (RAD50) 6 

TI UCB Address i 

Idletime 14 


Paces Record Length - 


16. bytes. 


i/o HOOK RECORD DEFINITIONS 
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H$SCTX - SAVE CONTEXT OF TASK 
LOCATION 
SYSXT.MAC 


After RESCH: CLR  $RQSCH 
Follow 73$: MOV. H.GARD(R3),R2 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB (Current Task TCB) 


Record Format - 


0 
Timestamp 2 
Taskname (RAD50O) 6 
TI UCB Address a2 
Idletime 14 


Record Length - 


16. bytes. 


HOOK RECORD DEFINITIONS 


mG H$LCTX - LOAD CONTEXT OF TASK 


ore LOCATION 


SYSXT.MAC 
After RESCH: CLR $RQSCH 
After 120$: MOV H.GARD(R2),R0 
Follow ~ENDC 


Oe DATA COLLECTION 


Seca Storage Dependencies - 


$TKTCB (TCB address of new task) 


5.262 Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


Idletime 14 


ory are Record Length - 


16. bytes. 


re coe! HOOK RECORD DEFINITIONS 
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ail 


“2 


H$USTP - UNSTOP TASK 


LOCATION 


REQSB.MAC 
After 
Follow 


DATA COLLECTION 


$EXRQN: :BIT 
Bic 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


Record Length - 


12. bytes. 


#T2.STP*2!T2.STP,T.ST2(RO) 
#T2.STP*2!T2.STP,T.ST2 (RO) 


12 
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H$QAST - QUEUE AST TO TASK 


LOCATION 
REQSB.MAC 
After $QASTT:: 
Follow 


DATA COLLECTION 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Hook I.D. 


Timestamp 


Es 


Taskname (RAD50) 


TI UCB Address 


Record Length - 
12. bytes. 


HOOK RECORD 


ADD #T.ASTL,RO 
CAl1 $SETCR 


2 


DEFINITIONS 


8.2. 


rarer 


eect 


«l 


3 


H$EXTK - EXTEND TASK 


LOCATION 


DREXP.MAC 


After SDREXPs = TSTB Te EOC { 


Follow 71$: 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB=TCB address 
RO=PCB address 


Record Format - 
| Hook I.D. 
-—— 


Timestamp 


eee Ree eee 
Taskname (RAD50) 


TI UCB Address 


Main PCB Address 


Task Size 


Record Length - 


16. bytes. 


MOV Rise 


Le 


14 


16 


HOOK RECORD DEFINITIONS 


R 
I 


5) 
ZE (RO) 


9.0 


eal 


9.2 


Gees 


eae 


2 a 


1 


2 


3 
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LOCATION 
REQSB.MAC 
After $TSKRP:: 
After 7$: 
Follow 


DATA COLLECTION 


Storage Dependencies - 


RO=TCB address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


Record Length - 


12. bytes. 


H$QTRP - QUEUE TASK REQUEST FOR PARTITION 


MOV R1RO 


12 


HOOK RECORD DEFINITIONS 


10.0 H$QLDR - QUEUE TASK LOAD REQUEST TO LOADER QUEUE 


10.1 LOCATION 


REQSB.MAC 
After $NXTSK::SAVNR 
After 255% 
Follow BISB -(RO),P.BUSY+1(R5) 


L052 DATA COLLECTION 


0 Peart Storage Dependencies - 
R1=TCB address 


10.2.2 Record Format - 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


10.2.3 Record Length - 
12. bytes. 


71 HOOK RECORD DEFINITIONS 


ser 


ll. 


i 


Li. 


ded 


Tie2a3 
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0 


1 


(ap 


mi 


LOCATION 
REQSB.MAC 
After $CHKPT:: 
After 50$: 
Follow 


DATA COLLECTION 


Storage Dependencies - 


R1=TCB address 


Record Format - 


- aa se 
Hook I.D 

| Timestamp 

etna rer tet oe ee Reece ree 
Taskname (RAD50) 

TI UCB Address | 

| T.ST2 

|e eee ee ot es eh ee oe 


Record Format - 


14. bytes. 


BIS 


12 


14 


Pi Sa CKPy beSTAL CRY) 


HOOK RECORD DEFINITIONS 


H$QCHW - QUEUE CHECKPOINT WRITE REQUEST TO LOADER QUEUE 


12.0 


Bae | 


L2s2 


Ae are | 


paw ary 


12.2.3 
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H$GLDR - GET REQUE 


LOCATION 
LOADR.MAC 
After $ 
Follow 1 


DATA COLLECTION 


Storage Dependen 


R1l=TCB address 


Record Format - 


ST FROM LOADER QUEUE 


LOADR::CA1] 
0$: MOV 


$SWSTK,40$ 
Ris LORUR 


cies - 


0 
Timestamp Z 
5 Taskname (RAD50) 6 
Ua See xis cee fo eee Pa = 
TI UCB Address IZ 
T.LDV 14 
Saris oe nae Seem anne 
P.MAIN 16 
———---- 
Pas bEeE 20 
T.STAT 22 


Record Format - 


20. bytes. 


HOOK 


RECORD DEFINITIONS 


13.0 


13.1 


Load 


Lose 


Lede? 


Bc i aes 


77841 


H$FLDR - FINISH LOADER REQUEST 


LOCATION 
LOADR.MAC 
After $LOADR::CAI11 
Follow 84$: 


DATA COLLECTION 


Storage Dependencies - 


R5=TCB address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


| 
[sc as a a a en 


ey yee | 
TI UCB Address | 
a ta er 


Record Length - 
12. bytes. 


$SWSTK, 40$ 
CAl1 $SWSTK,$LOADR 


HOOK RECORD DEFINITIONS 


14. 


14. 


14. 


14. 


14. 
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1 


oe 


2% 


1 


H$CREG - CREATE REGION 


LOCATION 
DRREG.MAC 
After $DRCRR:: 
After 74$: 
Follow BIS 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB=TCB address 
R4=Region's PCB address 


Record Format - 


Hook ID 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Main Par. PCB Address 14 
Region's PCB Address 16 
20 
Region name (RAD50) 22 


Record Length - 


22. bytes. 


HOOK RECORD DEFINITIONS 


#RS.CRR,R.GSTS(R3) 


15s 


LS 


14. 


15. 


15s 


1 


Le 


ek 


Md 


POEL 2s 
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H$DREG - DELETE REGION 


LOCATION 
DRREG.MAC 
After SDETRG: :MOV 
Follow 40$: MOV 


DATA COLLECTION 


Storage Dependencies - 


$TKTCB=TCB address 
RO=Region's PCB Address 


Record Format - 
Hook ID 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
Region PCB Address 14 


Record Length - 


14. bytes. 


A.PCB(R5),RO 
P.SUB(RO),P.SUB(R1) 


HOOK RECORD DEFINITIONS 


on 


16. 


16% 


16. 


16. 


LOsi2<3 
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va 


Di 


H$QDRV - QUEUE I/0 PACKET TO DRIVER 


LOCATION 
DRQIO.MAC 


After  $DRQIO:: 
Follow $DRQRQ: :MOV 


DATA COLLECTION 
Storage Dependencies - 
R1l=IRP address 


R5=UCB address 


Record Format - 


Hook I.D. 0 
Timestamp 2 
Taskname (RAD50) 6 
TI UCB Address 12 
UCB Address 14 
Function code 16 
20 


| IRP Address | 22 


Record Length - 


20% DYES 5 


HOOK RECORD DEFINITIONS 


U.SCB(R5),R4 


A-17 


17.0 H$GPKT - DRIVER GETS AN I/0 PACKET 


Li et LOCATION 


TOSUB.MAC 
After $GTPKT:: 


Follow 128$: CLC 
Vedat DATA COLLECTION 
ara Storage Dependencies - 
R1=IRP address 
R5=UCB address 
13202 Record Format - 
Hook I.D. 0 
Timestamp Z 
Taskname (RAD50) 6 
[pa 
TI UCB Address Iz 
oe eae a er _ ee 
IRP Address 14 
a Bie re Bertolt) 
LT e2e3 Record Length - 
14. bytes. 
7/81 HOOK RECORD DEFINITIONS 


Os 


Pos 


16s 


ee 


13: 


Levees 


7/81 


0 


if 


ae 


ae 


if 


2 


H$IODN - I/0 DONE PROCESSING 


LOCATION 


IOSUB.MAC 
Follow $I0ODON: :MOV 


DATA COLLECTION 


Storage Dependencies - 


R4= SCB Address 


Record Format - 


Hook I.D. 


Timestamp 


Taskname (RAD50) 


TI UCB Address 


IRP Address 


Record Length - 


14. bytes. 


U.SCB(R5),R4 


12 


14 


HOOK RECORD DEFINITIONS 


L320 


£9.44 


19.2 


Lovee 


POs 262 


19220:3 


7/81 


H$IOFN - COMPLETE 1/0 POST PROCESSING 


LOCATION 


IOSUB.MAC 
Follow $I0FIN:: 


DATA COLLECTION 


Storage Dependencies - 


R3=IRP address 


Record Format - 


Timestamp Ya 


Taskname (RAD50) 6 


TI UCB Address 12 
(a er aoe OR Re Se 


IRP Address 14 


cen 


Record Length - 
14. bytes. 


HOOK RECORD DEFINITIONS 


20.0 


aa 6 Pa 


22 


Cue eek 


20.2.2 


rasa) 


7/81 


H$QAC1 - QUEUE I/0 PACKET TO ACP 


LOCATION 
DRQIO.MAC 
After $DRQIO:: 


After FCXIT: 
Follow MOV U.ACP(R5),RO 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 


Record Format - 
Hook LD. 0 
ice | 
Taskname (RAD50) 6 
TI UCB Address 12 
UCB Address 14 
Function Code 16 
20 


| IRP Address | 22 


Record Length - 


20. bytes. 


HOOK RECORD DEFINITIONS 


rag ee 


21 


él. 


el. 


Zhe 


21 ces 


FSA 


1 


at 


.2 


LOCATION 
IOSUB.MAC 
After $GTPKT:: 
Follow 95$: 


DATA COLLECTION 


Storage Dependencies - 


R1l=IRP address 


Record Format - 


Hook I.D. 


| Timestamp 


Taskname (RAD50) 


aa ety 


TI UCB Address 


es 2 


UCB Address 


Function Code 


Record Length - 


20. bytes. 


HOOK RECORD DEFINITIONS 


H$QAC2 - QUEUE I/0 PACKET TO ACP 


1-2 


14 


16 


z2.0 


Zak 


Cee 


Lowea lL 


ag are A 


Leatad 


7/81 


H$GACP - ACP GET PACKET 


LOCATION 


DISPAT.MAC (FI1ACP) 
After ~START:: 
Follow MOV 


DATA COLLECTION 


Storage Dependencies - 


R1l=IRP Address 


Record Format - 


Hook I.D. 0 


Timestamp 2 


Taskname (RAD50) 6 


TI UCB Address 12 


IRP Address 14 


Record Length - 


14. bytes. 


$HEADR,RO 


HOOK RECORD DEFINITIONS 


235.0 H$DRSV - DIRECTIVE SAVE 
2301 LOCATION 
SYSXTsMAC 
After SDIRSVs : 
Follow MOV SP,@$HEADR 
2382 DATA COLLECTION 
Lou el Storage Dependencies - 
None 
CS SER A Routine - 
Timestamps system entrance time $BSTIM. 


O38 25:3 Record Format - 


None 


24.0 H$INSV - INTERRUPT SAVE 
24.1 LOCATION 
SYSXT .~MAC 
After SINTSV:: 
Follow MOV SP,@$HEADR 
24.2 DATA COLLECTION 
24.2.1 Storage Dependencies - 
None 
24.2.2 Routine - 
Timestamps system entrance time $BSTIM. 
24.2.3 Record Format - 


None 
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£5.09 
208) 


2ba2 


acre ae 


age aes 


Lee. 


26.0 


26.1 


26.1. 


206 Ly 


26.1. 


7/81 


1 


H$INS2 - INTERRUPT SAVE 
LOCATION 
SYSXT.MAC 
After SINT SCS: 
Follow MOV SP,@$HEADR 
DATA COLLECTION 
Storage Dependencies - 
None 
Routine - 
Timestamps system entrance time $BSTIM. 


Record Format - 


None 


H$SYXT - SYSTEM EXITS TO USER TASK 
LOCATION 
SYSXT.MAC 


After $ 
Follow 5 


DIRXT:: 
$: 


Storage Dependencies - 

None 

Routine - 

Copies current clock time, subtracts system entrance 
time ($BSTIM), and adds the resulting delta time to 
the total system time $TSTIM. 


Record Format - 


None 


HOOK RECORD DEFINITIONS A-25 


£14 
27s 


ove 
the 


a ie 


Zi 


28. 


28. 


28. 


28% 


28. 


20% 


i 


7/81 


ol 


H$EIDL - ENTER EXECUTIVE IDLE LOOP 


LOCATION 
SYSXT.MAC 
After RESCH: 
After 30$: 
Folow BNE 10$ 


DATA COLLECTION 
Storage Dependencies - 
None 


Routine - 


Copies current clock time, subtracts the system 
entrance time ($BSTIM), and adds the resulting delta 


time to the total system time $TSTIM. Timestamps idle 


entrance time $BIDLE. 
Record Format - 


None 


H$XID1 - EXIT EXECUTIVE IDLE LOOP 


LOCATION 
SYSXT.MAC 
After RESCH: 
Follow 46$: CLRB (R1) 


DATA COLLECTION 
Storage Dependencies - 
None 
Routine - 


Copies current clock time, subtracts the idle 


entrance time ($BIDLE), and adds the resulting delta 
time to the total idle time $IDLE. Timestamps system 


entrance time $BSTIM. 
Record Format - 


None 


HOOK RECORD DEFINITIONS 


2930 H$XID2 - EXIT EXECUTIVE IDLE LOOP 
29.1 LOCATION 
SYSXT.MAC 
After $FORKO:: 
Follow BCC SINTXT 
rags ad DATA COLLECTION 
Fo era area | Storage Dependencies - 


None 
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50.0 


30,1 


aUe2 
Seed 


Sete? 


30% 243 


ip ese! 


HSUSER - USER INFORMATION HOOK 


LOCATION 


QPDRV.MAC 
Follow QPINI: 


DATA COLLECTION 


Storage Dependencies - 


R1=IRP address 
R5=UCB address 


Record Format - 


eat 0 

Timestamp 2 

Taskname (RAD50)  °&| 6 
TI UCB Address — LZ 
| Function Code — 14 
16 
QIO Parameter [I  — 20 
Parameter 2. 22 
Parameter 3. 24 
Parameter 26 
Parameter 5 30 
Parameter 6. 32 


Record Length - 


28. bytes. 


HOOK RECORD DEFINITIONS 


Appendix B 
MPB DEFINITIONS 


Monitor Parameter Block 
The Monitor Parameter Block (MPB) is the data structure which 
contains the measurement parameters. These measurement 
parameters are defined by invoking the procedure @SMPGEN.CMD, 
which produces: 

) The binary MPB file (filename.MPB) 

fe) The source MPB file (filename. PAR) 

fo) The MPB saved answer file (filename.CMD) 


The COL task reads the MPB and initializes its databases from 
the MPB. 


The MPB has the following format and contents: 


Parameter Offset Size(wds) Values 

MPB ID word (I$MPB) M.PID 1 I$MPB 

Measurement label M.LABL 32% 

Buffer Type M.BTYP 1 DYNAMIC=0 
STATIC=1 

Buffer Count M.BCNT 1 

Buffer Size (bytes) M.BSIZ 1 

Buffer Size (64b blk) M.BS64 1 


List MPB DEFINITIONS B-1 


Parameter 

Buffer Partition Name 
SYS Partition Name 
Buffer Partition Addr. 
Buffer Partition Size 
Buffer Partition Flags 


Measurement Mode 


Sample Count (Buffers) 


Sample Interval Mag. 
Sample Interval Units 
Repeat Count 
Repeat Interval Mag. 

Repeat Interval Units 
Hook Bit Table 

I/O Selection Word 
Other Devices Sel. 
Device Class Mask 


Device Selection Mask 


S¥Ss Metrics Samp. Int. 


Sys. Metrics Partition 


Sys. Metrics Device 
TI Filter Device 

TI Filter Device Num. 
MPB Validation Word 


Task Selection Mask 


Task Selection Table 


F831 


Word 


Offset 
M.BPAR 
M.BPNM 
M.BPAD 
MeBTSZ 
M.BFLG 
M.MODE 


M.SCNT 
M.SINT 
M.SUNT 
M.RCNT 
M.RINT 
M.RUNT 
M.HTBL 
M.10S 

M.OTHR 
M.CW1M 
M.CW1S 
M.SAMP 
M.PART 
M.DEVC 
M.TIDV 
M.TINM 
M.VALD 
M.TKS 

M.TTBL 


MPB DEFINITIONS 


Size(wds) Values 


1 MANUAL=0 


AUTOSTOP=1 
REPEAT=2 


1 P$$VER 


Appendix C 
INFORMATION RECORD 
DEFINITIONS 


Information Record 


The Information Record provides system context data which can 
be correlated with the Hook Records to identify tasks, 
partitions, and I/0 device-units. 


In addition, there are Information Records which capture 
essential data when COL starts and stops data collection. 


I$SYS - System Common Information 


0 
Initial Pool Size 2 
$FMASK 4 


Dev. UCB Address 6 


7/81 INFORMATION RECORD DEFINITIONS C-1 


I$TCB - Task Control Block 


he 0 

I$TCB Record Size 2 

TCB Address 4 

TCB Contents 6 

I$PCB - Partition Control Block 

0 

I$PCB Record Size Z 

PCB Address 4 

6 


PCB Contents 


7/81 INFORMATION RECORD DEFINITIONS 


I$DCB - 


I$UCB - 


7/81 


Device Control Block 


0 
I$¢DCB Record 2 
DCB Address 4 
DCB Contents 6 

Unit Control Block 

0 
I$UCB Record Size Z 
UCB Address 4 


UCB Contents 6 


INFORMATION RECORD DEFINITIONS 


C-3 


I$CKP - Checkpoint File Information 


CKP. File Device UCB Addr. 2 


CKP. File Size 4 


I$TMR - Start Data Collection 


I$TMR 0 
System Time (Year) 2 
System Time (Month) 4 
System Time (Day) 6 
System Time (Hour) 10 
; System Time (Minute) 12 
System Time (Second) 14 
System Time (Tick) 16 
Ticks Per Second 20 
High KW11-P Time 22 
Low KW11-P ice, 24 


7/81 INFORMATION RECORD DEFINITIONS 


I$STM - Stop Data Collection 


Tfo4 


a 


I$STM 0 
-—————. 

System Time (Year) 2 

System Time (Month) 4 
Mie nage oe ok ea 

System Time (Day) 6 

System Time (Hour) 10 

12 

| System Time (Second) 14 

Syset ie (Tick) 7 16 
Siesta ere er aa 

Ticks Per Second 20 


fee 


High KW11-P Time ee 


Low KWL1-P Time 24 


CPU Kernel Time (High) 26 


Sn 


' CPU Kernel Time (Low) 30 
—— 
| CPU Idle Time (High) a2 


CPU Idije Time (Low) 


Go 
—> 


Device Usage Time (High) 36 


Device Usage Time (Low) 40 
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Appendix D 
SYSTEM METRIC 
RECORD DEFINITIONS 


System Metrics Record 
The System Metrics Record contains data which represents the 


system-wide usage of the CPU, pool, a selected memory 
partition, checkpoint file space, and a selected device. 


easy SYSTEM METRICS RECORD DEFINITIONS D-1 


High KW11-P Time 


Low KW11-P Time 


CPU Kernel Time (High) 


| CPU Kernel Time (Low) 
CPU Idle Time (High) | 
CPU Idle Time (Low) 


# Free Pool Nodes 


Total Free Pool Space (bytes) 


| Smallest Pool Node (bytes) 


Largest Pool Node (bytes) 

Main Partition PCB Address 
Number of Subpartitions 
Total Space Used (32W blks) 

Eos ec eens, 


Total CKP.File Space 


Total CKP.File Space Used 


UCB Address of Device 


Device Usage Time (High) 


Device Usage Time (Low) 
) 


Free Disk Blocks (High 


Free Disk Blocks (Low) 


~~ 


SYSTEM METRICS RECORD DEFINITIONS 


D-2 


1.0 DISK LOGFILE FORMAT 


Appendix E 
LOGFILE FORMAT 


A logfile on disk is a Files-1l1l file with the following format: 


7/81 


BUFFER 
#1 


BUFFER 
#2 


BUFFER 
#M 


LOGFILE FORMAT 


Each BUFFER has the following general format (byte 
offsets): 


Record Count 0 


x$xxx is I$, H$ or 
S$ record ID. 


See appendices 
A, Bs G-and D. 


Wee Spac 


7/81 LOGFILE FORMAT E-2 


All BUFFERS are the same length. The BUFFER size in 512B 
blocks is derived from the BUFFER size in bytes which is 
stored in the MPB in BUFFER #1: 


BUFFER #1 Format (byte offsets) 


Record Count | 0 


Overflow Count 


4 Note: 
I$MPB is the lst record; 
ISSYS is: the 2nd. records 
; X$xxx Ts 16, HS or S$ 
‘ : record ID. 
See appendices 
Aes Bia Gand: Di. 


BUFFER Size (bytes); 4+M.BSIZ 


L$Syvs 


X$XXX 


BUFFER size (blocks) = BUFFER size bytes 


Py/3) LOGFILE FORMAT E-3 


2.0 MAGTAPE LOGFILE FORMAT 


A magtape can contain one or more logfiles. Each BUFFER. 75 
terminated by an IRG. Each logfile is terminated by a tape 
mark (EOF). The magtape is terminated by a double tape mark 
(EOF EOF). Each BUFFER has the same format as for disk. 


BUFFER 
#1 


BUFFER 
#M1 


BUFFER 
#1 


e 


end of logfile #1 


BUFFER 
#Mn 


La ECR | 


end of logfile #n 
end of tape 


7/81 LOGFILE FORMAT E-4 


os U FCS LOGFILE FORMAT 


Tre CLE weal Tey task can: bé “esed to convert 2 logfile trom: che 
formats specified in section 1.0 and 2.0 to a file containing a 


stream of variable length FCS records. Each FCS record 
contains one record of type H$xxxx, I$xxxx or SO XEXKs The 
TiIvst. wor of each record contains the record ID, H$xxxx, 
CERRO Or -SSRKK Ks The record formats are specified in 


Appendices A, B, C and D. 


See Chapter 3, Section 3.2.5 for using CLF. 
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Appendix F 
EXAMPLE PERFORMANCE 
REPORT 


taggng 


Sux¥alawvyyvd 


SiBPIWEILY VOTYIATIOJ sozrusdy 


SL/222°21S/EWYSC ES TTIsad=dS-/2wys<auty~T puewwod yw 


cgrx %$TTIX WIS LXAS CSNI ASNI ASH (CAaTPI/WaySsS) 


é€9¥0 T3990 NSOI NOI do¥9 Lvd9d = ANTO CFHSAyNQ/UT) 
ygdd 4019 MHOO YdTO (4apeo7 ysel) 

934d 934Y9 dylO Wixa LS¥0 disn CARLOW ay) 

XL970 XL9S (apesn dd) 

WSLX MGLY CPEB /UNY) 


(Saat zIadTY) 
{US1GYN3 24e SINIOd NOOH BUTAOTTOY ayy 


adwa’’* SNI°** TZdil 99° OWO °° UGH MONT * dDVTTS 
$(S)4S@L BUTMOTTOS 844 LddOXE TY 40g PaTqeug voTzoaTIO] eyeq PeOTyLOM 4Se1 


S3d¥1i SNSID $PaI9aTaS S3IINAT PeOTysOM ySeL 

SOM] aotraagq pue « NID 4YOTFTPVEY “Nd 94% 104 SPUGIAS O9 AVBAS PapioOdad sotTuzaw AapPTM—waysAS 
4ad SYIOTA B YZIM Suagsng | YO * NAD YOTYTIVed UT YYdINL PATTe@I VOTBaL JIWYNAM @ UT BUTJagyng 
TYANYW 2 apoy 


NOTLlLIQAaTI1O9I vilevd YOlLINOW 23INVANOAN AG 


T8-NNAF-B NOISY3SA MAGN : 
& 


T a6ed 20;TSi+T TS8-NNr-Bt OOOTTOA YOTPONPaYy eyed sOPTUOW saueWIOsiad WIT-XSH 


EXAMPLE PERFORMANCE REPORT F-1 
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oe 


WHWWHA HWW WAH WW WW HN AA A BE 


ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddda 


ADDED DAD NN ANANANNARANANANANANANANANAAANANNANANANANANANANANANAANANANANANANANAAANAANANANANANANN 
$CC*BS20160) EL9OFOILOETOO +e 


HH aadd dd ddeadarg 
POCO OTT 
33393933 


WALA 8 be 


ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd 


AD DP DDPE DD ADDD ANAT AT AN AAAAAANAANATANANNANANANANAANAANANANARNANARANANNANANANARNANANAAANAANANANAANAN 
PCS°BSI6EL60) OSTHETIZEOTOO 3e 


ded dd ddadgagaag 
WIddddddddddg 
929399 


WHR RE 0 


dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd 


SD SD_B DDD DDD DDD ARAN ARN ANANANAANARANAANANARANARNANANNANANAANANAAANAANANANANAAAARANAAAAAANAANANANAN 
eC T*BSIBE60) LELZ00i v1 L000 32 


Haddad dada 
Tdddadddddddd 
393959 


DRL EU Rd 


dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd 


APP DDD DDD ppp NTANNANNANNANANANANAANAANAANAANAANAAANANAAAAAAAAANANAAANANAANANNANMARAAAAANAANAANNA 
PCT BSI ZE260) £22~20109S5000 72 


Hadad dddaddaaaa 
T1ddddddddd ddd ddadadaddddgaddada 
93399939 


DOL SAU 


SDSDDDDDDD DN 

4S DEN 

DDD 
CUOTZEZTITIN Z) OOT + 


STeACaUT BUTTaweS 


dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd 
ANAANAAARAANAANAARAANAANAANAANNANAANANANAANNANAANARNA 


apesg 
apesy 


Sala 
aqsng 
aoedg 


apesn 
apesy 


S4Td 
Asng 


aoeag 


apesy 
apesy 


Sata 
Asng 


aoeds 


apesn 
apesy 


S4td 
Asng 
adedsg 


apesy 
apesy 


P(E BSI9E260) wHITOTivzZ¥000 72 


Fad adsdgagaadag 
Tddddddddddadagquiaaad 


YU EB HB Yd Bd Bd dF 0d PD dF od PB PB ad TB 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddd 
ANANAANANAARANAAARANANANANAANNNANANAANNANAANANANANAANANNANANANAAAAAAANAAAAAANANANN 


Sula 
ASng 
aoedg 


apesn 
apesn 


PCT BEIGE6O) GLO9eOLTZZ000 32 


Hddddddddadaaia 
Taddddadddddadadaadadgagd 


Wea WU St BH TT BI Ld PF oa dd Fd dd dP Sd 
ddddddddddddddddddddddddddddddddddddddddddddddddddddddg 
ANANRANANAANAAANAAANANAANANAANARANAN 


S4ld 
aAsng 
a0e4dg 


apesy 
apes 


$CO*BSIHLI6O) TTIZTLTISETOOO 42 


os + 09 + Ov + 0g + 


0) 


N39 
164 

no 
BUTpUS 


:08a 
30ag 
dno 
N39 
100d 
4a 
BUTpUAa 


2081 
208g 
44M 
NaS 
1004 
nda 
BUT BUS 


2081 
204d 
LdN9 
N39 
1004 
Add 
BpUTpUAa 


:08g 
$0ad 
Ldyd 
N39 
100d 
Add 
BUTpUAa 


3040 
308 
LdN3 

N39 
1004 


Ado 
BUTpUSa 


;Oa0 
+080 
41dNO 
N39 
100d 
ndd 
BUTpUAa 


P¥e0ZO ZO000O OF BSILL1460 TB-NAF-ST Paqseys vorzyoaT{og eyeq 


TB-NNC-8 NOISHYSA MAN 


@ 868d Z0O:;TSivt T8-NNr-st OOO'TON YOTPINPSY e3ey 4OFTUOW aouewsOssay WIT-XSH 
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EXAMPLE PERFORMANCE REPORT 


ELS 


WHWWWWH WWW WWW WWW WWW WWW WWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd aBesn 
NNNNNMN ANnANANN apesn 


$(b 'BStLZet60) 9ETOOTI POFCOO 42 


PCCE CEE G COCR b| SATY 
q ASnY 
5) aoe84g 
WHWWHWHWWWWHWRWWW RWW RWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd apesn 
MNM ANANAN sBesn 
$e °8S39b260) OSLOFTIOSTEOO Fe 


PCC CCC CCECELEE ES S4Ta 
GAdAddI AAI Idd dddaAaAANAdadadadadddddddddddddadddan RSsng 
e) aoedg 


WHWWHWWHWWHWWHHWWHWW AWWW WH 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd apesn 
UNE DDN OD SDN SDE nAAAAAANANAAAAAANNAAAAAAANANAN apesn 
TCE'SSISHi60) LyocvO:STIcooO 32 


aqgqgddadddaddasia Sala 
POTVCCOUUUCOCO COO COOCCONCOCUCOCUOUOUCUCOULODUCUCUCOULUOUCOOOOCOCOUDOR: ASN 
a a0eds 
HHWHWHWHWHWWWHW WHR WWW WWW WWW WWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd apesn 
MN MN EEE MN EN DN ON EM ANANARAANANAAANAANNAAANAAANNANANANHANN apesn 


SCE*BSIHHI60) POLVETITIZTOO 38 


qaqagagqdgaaadad Sata 
CUCadd ddd AAAI ad Ada addAdadaddddddadddddddddadaddddadddddadaadaadig ASng 
3 aoeds 


WWHHWWHWNHRWWHWHWWWWWW WWW WWW WWW WWW 


dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd apesn 
EN MM EIEN END SSE ANAANAAANAAAANAANANAAAAANANANAAANAAANAANA apesn 


SCE*BSILH 140) LOVLOO9TITOO Fe 


HaAgddggaddaadada Sala 
IAdddadddadaadaddadddaddadddAdadIdddaIddsad Asn 
fa) aoeds 


WWWHWWWWWWWHWWHWWW WWW HW WWW WWW RWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd asesn 
SDA DDD DDD IDS DDSI ANANANAAANANANNANNAARAANA apesn 
P(E°BS8S7360) FPOVTLOLELYTOO 3 


SECC EOC COG EE Et Eb Sula 
PUMUCCOUORU OOOO eo tie BSnY 
9 aoeds 
HHWHWWWWWWWWWHWWRWWWW WWW WWW WWW WWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd anes 
MAWSON ANAANAANANAANANAANNAANANNAANANAAANNAA oBES 
LCE°BSITy3 60) OTLZESTIPLETOO © 


CECE EC ECEE CE EEEE| SATA 
Damier RSNA 
3 aoe4s 


T8-NAC-B8 NOISHSA MAN 


& 


Nad 
104 
ndd 
BUT DUS 


:Oad 
{Odi 
Ldno 
NAd 
WwoO8!d 
nda 
BUIpuAa 


:0ad 
$0an 
LdN3 

N39 
100d 


nd 
BUT PUA 


204d 
$08 
idNd 
N39 
10d 
N43 
BUTpUa 


;Oad 
304d 
idNo 

N39 
1004 


nd 
BUTpUa 


308d 
:oqd 
Ld 

N39 
1004 


ndo 
BUTpUS 


:oag 
20480 
1dN3 
Nao 
100d 
ndo 
BUTpUAa 


rok: | 
SOT 
LdNo 


STeAsayUT BUTTaMes g aped ZOtTSibT TB-NNP-8T OOO'TOA HOTIINPSY e3eq 1OFTUOW aouemOjIaY WIT-XSM 
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EXAMPLE PERFORMANCE REPORT 
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CUOTZEZTTTIN ZZ) OOT + 


NAN N 


YN IMS EM NM 


STeAsaqyuy BUTTswes 


LZ6CTT' O8S=89TAag 


038 


’ aB6ed 


EOLTH'S9S = (SPu0daS) potuag YOTJONMpay eyed 


906b* O9L=FTPIT L6B9L°4LT=TaUIaN LOLTH*S96=Pasde Ty 


SLvSLo £OZ7Z00 6°20206260 TB-NN-ST 


09 + Ov + Oz + 9 
PECCE CECE CECEE E| Sula 
adddadadadaddadddadadddadddaddddadaddtig RSng 
aogeds 


WWWHNWWHWWWHHWHA WHR 


ddddddddddddddddddddddddddddddddddddddddddddddddddddddddd apesn 
ANANAAAAANAAAAN apesn 

£¢6°BSI4b'60) SIEPLTILLITON Ve 

dqagdadddadadada s4td 

TAIT IdAdddddddddddaddddddddddddadadddaddadddaddadda RSng 

agedsg 


WHWHWHWWWHWRWWWHWW WWW WWW 
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd 
ANAANAANAANAARAANANA 


apes 
apesn 


$(S*SS2B¥i60) PSETLTOLOVSEOO Fe 
PECECCCOCCE ECE EE! S4ld 
TWIIIIA ASN 
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Appendix G 
EXAMPLE SMPGEN 


au 


>SET /UIC=C1i1»2] 

>@SMPGEN 

>} 

>o*aK Software Monitor Parameter GENeration command file xxx 
>9 

>3KRK Version 1 KX 

>9 

>$3Copyright (C) 1981 Disital Eauiement Corporations Maynards Mass. 
>> 

>3 

>¢ Initialize default Parameters 

>* 

>* READ SAVED ANSWER FILE FOR DEFAULT ANSWERS? CY/NIIN 

>* 

>$ Select parameter catesdory, type <esc> for hele 

>9 

> ENTER PARAMETER CATEGORY CSIJ3 

>s 

> LEGAL FARAMETER CATEGORIES ARE 3 

>9 HOOK TASK MODE LABEL 
>¢ BUFFER DEVICE SYSTEM DONE 
>F 

>K ENTER PARAMETER CATEGORY CS]? HOOK 

>3 

>s Select/deselect hook Points 

>> 

>* CPU USAGE HOOKS? CY/NIZY 

> MEMORY USAGE HOOKS? CY/NItN 

>* I/O DEVICE USAGE HOOKS? CY/NIT°Y 

>$ 

>3 Select parameter catedorys ture <esc> for help 

>9 

>® ENTER PARAMETER CATEGORY CS1$ BUFFER 

>3 

>) Setup buffer management rarameterys tyre <esc> for help 

>% 

> ENTER BUFFER TYPE CDS BDYNAMICI CS Rt0-733 

>k ENTER NAME OF BUFFER MAIN (SYS) PARTITION CDOiGEN] CS R:0-6]3 
>K ENTER NAME OF BUFFER COMMON/REGION CDi TRCPAR] CS R30-46]3 
>*k ENTER NUMBER OF BUFFERS CD Ri22.-8. Di2.3: 3 

> ENTER BUFFER SIZE IN S512B BLOCKS CD Riti.-i6. D28.33 6 

>s 

>$ Select eparameter catesdory, ture <esc> for help 

>§ 

>* ENTER PARAMETER CATEGORY CSJ:3 TASK* 


>¢ Select/deselect tasks to be traced 


>x DO YOU WANT TO TRACE ALL TASKS? CY/NIEN 
>*x DO YOU WANT TO SPECIFY THE TASKS NOT TO TRACE? CY/NI:Y 


> Enter one taskname rer line. Terminate list by <CR>. 
>e ENTER NAME OF TASK NOT TO TRACE CS]? FILlACP 

>* ENTER NAME OF TASK NOT TO TRACE CS12 MCR.«e 

>* ENTER NAME OF TASK NOT TO TRACE CSI? QHNG... 

>* ENTER NAME OF TASK NOT TO TRACE CSI? LFPO 

>* ENTER NAME OF TASK NOT TO TRACE CSTi 


Select parameter catesdorys tyre <esce> for help 


ENTER PARAMETER CATEGORY CSI; DEVICE 
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BDO YOU WANT TO COLLECT DATA FOR ALL DEVICES? CY/NI3N 
Select device tyres to be traced 


TRACE DISK (DIRECTORY DEVICE) I/O ACTIVITY? CY/NILY 
TRACE TAPE (SEQUENTIAL DEVICE) 1/0 ACTIVITY? LY/NILY 
TRACE TERMINAL I/O ACTIVITY? CY/NIiN 

TRACE ALL OTHER DEVICES I/0 ACTIVITY? CY/NIIN 


vv vw 


Select parameter catedoryus type <ese> for help 
ENTER PARAMETER CATEGORY [ECS]? MODE 
Define data collection moder type <esc> for help 


ENTER MODE CDiMANUALI CS RtO.-8.]2 


VVY MY VY Ye Yo 
ye Oo BE er war er BE er wo we Bb RE HE FE ar ar woo $e 


>s LEGAL MODES ARE: 
>$ MANUAL AUTOSTOP REPEAT 
>5 


2% ENTER MODE CD3MANUALI CS R30.-8.13 AUTOSTOP 
>% ENTER SAMPLE TYPE CS Ri0-6]3 


>$ LEGAL SAMPLE TYPES ARE? 

>3 BUFFER TIME 

> ENTER SAMPLE TYPE CS R20-633 TIME 

>* ENTER SAMPLING INTERVAL TIME UNIT CDSMIN] CS R20-3]! HR 
>% ENTER SAMPLING INTERVAL IN HRS CD R$1.-10000. Dsi.3i 2 
> Select parameter catedorys ture <ese> for hele 

>& ENTER PARAMETER CATEGORY (S12 SYSTEM 


>§ Select system metrics 


7% DO YOU WANT THE SYSTEM-WIDE METRICS? CY/NILY 
>& ENTER SYSTEM METRICS SAMPLING INTERVAL (SECS) CD R$15.-28800. Dié60.33 120, 


>% Select parameter catesoruy type <esc> for help 

7k ENTER PARAMETER CATEGORY (£817? LABEL 

>§ Define 1 to 63 character label stringy type <esc> for help 
7% ENTER MPB LABEL £S R$0-6333 THIS* IS A SAMPLE MPB GENERATION 
7% Select parameter catedoryus type <esc> for hele 

ENTER PARAMETER CATEGORY [CS]: DONE 


Write saved answer file and parameter source file 
Enter <esc> if no output file is desired 


Vv wv 


>*% ENTER NAME OF SAVED ANSWER FILE CDETRACE.CMD] CS]! SAMPLE.CMD 

>% ENTER NAME OF PARAMETER SOURCE FILE CDi TRACE.PAR] C513 SAHPLE.PAR 
>MAC’ SAMPLE=CiislOIRSXMCeCii»s2IHKMACsCil,s21SAMPLE.PAR 

>TKB @PARBLD 

>PIP SAMPLE.OBJ#*/DEsPARBLD.CMDs& 

>@ <EOF> 

> 
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